PERSONAL INTEGRATION
接入一次，随时准备发布。
通过 REST 上传素材，或让 AI 助手通过 MCP 创建任务。生成二维码后，手机扫码带入小红书，由你检查并确认发布。
下载完整接入文档 ↓01 · 个人 Key
使用单独生成的个人 API Key，与网页工作台 Key 分开。Key 只放在请求头，不放在链接或工具参数里。本页面不会展示真实密钥。
Authorization: Bearer YOUR_PERSONAL_KEYKey 保存在服务器 /etc/fabu/env 的 API_KEYS_JSON。替换并重启服务即可撤销旧 Key，已有任务和网页登录不受影响。
02 · MCP 连接
Streamable HTTP · https://fabu.uwenai.com/mcp
选择支持自定义请求头的客户端，填写地址和 Authorization。本服务使用个人 Key，不提供 OAuth 登录。
{
"mcpServers": {
"fabu": {
"url": "https://fabu.uwenai.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_PERSONAL_KEY"
}
}
}
}| 工具 | 能力 |
|---|---|
get_service_info | 查看服务和限制 |
create_publish_task | 提交文本与媒体 base64，获取链接、二维码 |
list_publish_tasks | 列出自己的任务 |
get_publish_task | 查询指定任务 |
cancel_publish_task | 取消任务并停止新访问 |
MCP 一次所有文件解码后最多 20 MiB。较大的素材集合或视频，请使用 REST 文件上传。
03 · REST 上传示例
export FABU_API_KEY='你的个人 Key'
curl --fail-with-body https://fabu.uwenai.com/api/publish-tasks \
-H "Authorization: Bearer $FABU_API_KEY" \
-F 'title=周末的生活记录' \
-F 'content=把今天值得记录的片段分享给你。' \
-F 'topics=["生活记录","周末"]' \
-F 'media_type=image' \
-F 'media=@/absolute/path/01.jpg;type=image/jpeg'返回 task_id、publish_url、qr_data、PNG qrcode 和有效期。按上传顺序带入素材；视频改用 media_type=video，上传一个 MP4。
| 方法 | 接口 |
|---|---|
| POST | /api/publish-tasks · 创建任务 |
| GET | /api/publish-tasks/ · 任务列表 |
| GET | /api/publish-tasks/{task_id} · 任务状态 |
| POST | /api/publish-tasks/{task_id}/cancel · 取消任务 |
04 · 使用边界
图文最多 9 张，每张 ≤10 MiB；MP4 视频 ≤100 MiB、H.264/AAC、10 分钟内。任务默认 24 小时失效，不支持代抓远程媒体 URL。
跳转到小红书后，由你检查并发布。handoff_started 仅表示交接意图，没有“已发布”状态。手机浏览器兼容性依具体版本而定，微信请在系统浏览器打开。