Flomo via App
Send notes to flomo using URL Scheme, with automatic webhook fallback for reliability.
⚠️ 首次使用提示: 安装后请先运行 ./scripts/configure.sh 进行配置
Quick Start
1. 配置（首次使用必需）
CODEBLOCK0
运行后会交互式询问：
- 1. 是否有 flomo PRO 账户
- Webhook token/URL
- 保存位置（默认保存到 skill 目录的
.env 文件）
配置默认保存到 .env 文件，这样更便于管理和隔离。
2. 发送笔记
CODEBLOCK1
Or manually via URL scheme:
CODEBLOCK2
How It Works
The script uses a dual-channel strategy for maximum reliability:
- 1. Primary: URL Scheme → Opens flomo app directly (instant, local)
- Fallback: Webhook API → HTTP POST to flomo servers (works without app)
If the flomo app is not installed or open command fails, it automatically falls back to webhook.
Script Usage
Basic Usage
CODEBLOCK3
Webhook Configuration (Optional)
If you ran ./scripts/configure.sh during setup, webhook is already configured.
To manually configure, set environment variable:
CODEBLOCK4
Supported Actions
Send Text Note
CODEBLOCK5
Send with Tags
Tags in format
#tagname will be automatically parsed by flomo.
CODEBLOCK6
Multi-line Notes
CODEBLOCK7
Send with Images (URL Scheme only)
Note: The
flomo_send.sh script currently supports text only. To send images, use URL Scheme directly:
CODEBLOCK8
Image URLs must be:
- - Publicly accessible URLs
- URL-encoded JSON array format
- Maximum 9 images per note
See references/api.md for more details on image parameters.
URL Scheme Format
Direct URL scheme usage (macOS only):
- - Base URL: INLINECODE7
- Parameters:
-
content (optional): The note content, URL-encoded, max 5000 chars
-
image_urls (optional): JSON array of image URLs, URL-encoded, max 9 images
Examples
Text only:
CODEBLOCK9
With images:
CODEBLOCK10
The image_urls parameter format:
- - JSON array of publicly accessible image URLs
- Must be URL-encoded with INLINECODE11
Examples
Save a link:
CODEBLOCK11
Daily journal:
CODEBLOCK12
Quick idea capture:
CODEBLOCK13
Remote/SSH session (uses webhook):
CODEBLOCK14
Requirements
⚠️ API 和 URL Scheme 功能需要 flomo PRO 会员 才能使用。
URL Scheme (Primary)
- - macOS with flomo app installed
- flomo app v1.5+ (supports URL Scheme)
- flomo PRO 会员
Webhook Fallback
- -
curl command available - INLINECODE13 or
FLOMO_WEBHOOK_TOKEN environment variable set - flomo PRO 会员
Limitations
- - Content: Maximum 5000 characters (before URL encoding)
- Images: Maximum 9 images per note (URL Scheme only; webhook does not support images)
Configuration
Environment Variables
| Variable | Description | Example |
|---|
| INLINECODE15 | Full webhook URL | INLINECODE16 |
| INLINECODE17 |
Webhook token only |
abc123 |
Persistent Configuration
Add to your ~/.bashrc, ~/.zshrc, or ~/.bash_profile:
CODEBLOCK15
Troubleshooting
"Error: Webhook not configured"
→ Set FLOMO_WEBHOOK_URL or FLOMO_WEBHOOK_TOKEN environment variable
"Error: flomo URL scheme failed"
→ Normal if app not installed; check if webhook fallback succeeded
Unicode/Chinese characters not working
→ The script auto-encodes UTF-8; if issues persist, check Python3 availability
API Reference
For detailed webhook API documentation, see references/api.md.
技能名称: flomo-send
详细描述:
通过 App 使用 Flomo
使用 URL Scheme 向 flomo 发送笔记，并自动通过 webhook 回退确保可靠性。
⚠️ 首次使用提示: 安装后请先运行 ./scripts/configure.sh 进行配置
快速开始
1. 配置（首次使用必需）
bash
./scripts/configure.sh
运行后会交互式询问：
- 1. 是否有 flomo PRO 账户
- Webhook token/URL
- 保存位置（默认保存到 skill 目录的 .env 文件）
配置默认保存到 .env 文件，这样更便于管理和隔离。
2. 发送笔记
bash
scripts/flomo_send.sh 你的笔记内容 #标签1 #标签2
或通过 URL Scheme 手动发送：
bash
open flomo://create?content=Hello%20World&tag=daily
工作原理
该脚本采用双通道策略以最大化可靠性：
- 1. 主要通道： URL Scheme → 直接打开 flomo 应用（即时、本地）
- 回退通道： Webhook API → HTTP POST 到 flomo 服务器（无需应用）
如果未安装 flomo 应用或 open 命令失败，会自动回退到 webhook。
脚本使用
基本用法
bash
简单笔记
./scripts/flomo_send.sh 我的快速想法
带标签
./scripts/flomo_send.sh 今天的会议记录 #工作 #会议
从剪贴板
./scripts/flomo_send.sh $(pbpaste) #剪藏
从标准输入
echo 来自管道的笔记 | ./scripts/flomo_send.sh
Webhook 配置（可选）
如果在设置时运行了 ./scripts/configure.sh，webhook 已配置完成。
若要手动配置，设置环境变量：
bash
选项 1：完整的 Webhook URL
export FLOMO
WEBHOOKURL=https://flomoapp.com/iwh/xxxxxxxxxxxxxxxx
选项 2：仅 Token
export FLOMO
WEBHOOKTOKEN=xxxxxxxxxxxxxxxx
然后运行脚本
./scripts/flomo_send.sh 带回退的笔记 #测试
支持的操作
发送文本笔记
bash
./scripts/flomo_send.sh 你的笔记内容
发送带标签的笔记
#标签名 格式的标签会被 flomo 自动解析。
bash
./scripts/flomo_send.sh 阅读笔记 #书籍 #学习
多行笔记
bash
./scripts/flomo_send.sh 第一行
第二行
第三行 #日记
发送带图片的笔记（仅限 URL Scheme）
注意： flomo_send.sh 脚本目前仅支持文本。要发送图片，请直接使用 URL Scheme：
bash
直接通过 URL Scheme（最多支持 9 张图片）
open flomo://create?image_urls=%5B%22https://example.com/img1.jpg%22%5D&content=Photo%20notes
图片 URL 必须满足：
- - 可公开访问的 URL
- URL 编码的 JSON 数组格式
- 每条笔记最多 9 张图片
更多图片参数详情请参见 references/api.md。
URL Scheme 格式
直接使用 URL Scheme（仅限 macOS）：
- - 基础 URL： flomo://create
- 参数：
- content（可选）：笔记内容，URL 编码，最多 5000 字符
- image_urls（可选）：图片 URL 的 JSON 数组，URL 编码，最多 9 张图片
示例
仅文本：
bash
open flomo://create?content=你的%20URL%20编码%20内容
带图片：
bash
open flomo://create?image_urls=%5B%22https://example.com/img.jpg%22%5D&content=Photo%20notes
image_urls 参数格式：
- - 可公开访问图片 URL 的 JSON 数组
- 必须使用 encodeURIComponent 进行 URL 编码
示例
保存链接：
bash
./scripts/flomo_send.sh https://example.com/article #稍后阅读 #技术
每日日记：
bash
./scripts/flomo_send.sh 晨间反思：今天感觉效率很高 #日记
快速捕捉想法：
bash
./scripts/flomo_send.sh 应用创意：AI 驱动的植物浇水提醒 #创意
远程/SSH 会话（使用 webhook）：
bash
export FLOMOWEBHOOKTOKEN=你的-token
./scripts/flomo_send.sh 来自服务器的笔记 #服务器日志
系统要求
⚠️ API 和 URL Scheme 功能需要 flomo PRO 会员 才能使用。
URL Scheme（主要通道）
- - 已安装 flomo 应用的 macOS
- flomo 应用 v1.5+（支持 URL Scheme）
- flomo PRO 会员
Webhook 回退
- - 可使用 curl 命令
- 已设置 FLOMOWEBHOOKURL 或 FLOMOWEBHOOKTOKEN 环境变量
- flomo PRO 会员
限制
- - 内容：最多 5000 字符（URL 编码前）
- 图片：每条笔记最多 9 张图片（仅限 URL Scheme；webhook 不支持图片）
配置
环境变量
| 变量 | 描述 | 示例 |
|---|
| FLOMOWEBHOOKURL | 完整的 Webhook URL | https://flomoapp.com/iwh/abc123 |
| FLOMOWEBHOOKTOKEN |
仅 Webhook Token | abc123 |
持久化配置
添加到你的 ~/.bashrc、~/.zshrc 或 ~/.bash_profile：
bash
export FLOMOWEBHOOKTOKEN=你的-webhook-token
故障排除
错误：Webhook 未配置
→ 设置 FLOMOWEBHOOKURL 或 FLOMOWEBHOOKTOKEN 环境变量
错误：flomo URL scheme 失败
→ 如果未安装应用属正常情况；检查 webhook 回退是否成功
Unicode/中文字符无法正常工作
→ 脚本会自动编码 UTF-8；如果问题仍然存在，请检查 Python3 是否可用
API 参考
有关详细的 webhook API 文档，请参见 references/api.md。
