Reeling

Reeling MCP 服务

Reeling 的官方开源 Model Context Protocol (MCP) 服务，Reeling 是一个 AI 社交媒体排期工具和短视频发布平台。

可通过 Claude Desktop、Cursor、Windsurf、OpenClaw、兼容 ChatGPT 的连接器或你自己的 MCP 客户端使用 Reeling。该服务为 AI Agent 提供受控接口，用于跨平台发布社交内容、排期、分析、管理受众评论和改编内容。

本仓库是 Reeling 面向开发者的公开配套项目，其中包含 MCP 适配器；可运行的 API 示例位于 reeling-examples；Reeling 的私有应用、生产基础设施、客户数据和凭据均不属于本仓库。

链接：Reeling 主页 · AI 插件与技能中心 · 15 个频道集成 · 开发者门户 · 托管 MCP 安装 · API 设置 · 定价

---

平台集成（支持 15 个频道）

可用性取决于已连接的账号、应用访问权限和当前功能。TikTok 收件箱投递需要在 TikTok 中完成；X（伴侣模式）、Reddit（伴侣模式）、Medium 和 Quora 使用 Reeling Companion Chrome 扩展桥接已通过身份验证的浏览器会话。发布前请查看当前平台列表。

• 🎵 TikTok
• 📸 Instagram Reels 和 Stories
• ▶️ YouTube Shorts 和视频
• 🦋 Bluesky
• 🧵 Threads
• 📌 Pinterest
• 💼 LinkedIn
• 🐦 Twitter / X（OAuth 2.0 或免费伴侣桥接）
• 👽 Reddit（伴侣桥接或脚本 OAuth + 主题雷达与垃圾信息屏蔽）
• ❓ Quora（伴侣桥接 + 问题雷达与 75 词举证责任屏蔽）
• ✍️ Medium（伴侣桥接 + AI 陈词滥调与标签屏蔽）
• 📘 Facebook Pages
• 💬 Discord 和 Telegram
• 🐘 Mastodon

---

🛠️ 可用的 MCP 工具（16 个工具）

工具名称	描述
reeling_list_projects	列出 Reeling 账户中的所有项目和工作区。
reeling_list_channels	列出所有 15 个网络中已连接的频道，并显示账号名称和账号状态。
reeling_get_channel_options	获取已连接频道的发布选项，例如 Pinterest 版块（ID、名称、隐私设置）或 TikTok 创作者选项。
reeling_publish_post	在指定平台发布或安排发布短视频、文章或社区回答（包含发布前垃圾内容防护，以及每日 3 次、每周 3 次的发布频率限制）。
reeling_get_post_status	查看指定帖子的投递、处理和发布状态。
reeling_discover_community_questions	在 Reddit 和 Quora 上发现与你的主题匹配、意向度高的每日问题，并返回剩余的每日／每周发布频率配额。
reeling_draft_community_answer	为 Reddit 或 Quora 帖子生成以提供价值为先、无推广性质的回答，并评估其 0–100 分的发布前垃圾内容与影子封禁评分。
reeling_get_analytics	获取汇总分析数据：总浏览量、点赞数、评论数、展示次数以及各平台的数据明细。
reeling_sync_metrics	触发与 YouTube、Bluesky、Instagram、Threads 和 TikTok API 的实时同步。
reeling_evaluate_content_jev	使用 Reeling 的 JEV 钩子和留存诊断功能评估视频脚本和说明文字。
reeling_get_inbox	将各社交频道的受众评论汇总到统一收件箱。
reeling_reply_to_comment	在任何已连接的社交平台上直接回复评论。
reeling_adapt_content_ai	使用 Reeling 的 AI 文案引擎，为 TikTok、Instagram、YouTube、Threads 或 Bluesky 改编钩子／脚本。
reeling_generate_video	通过 Reeling 配置的服务请求生成短视频；具体受套餐额度和服务提供商处理情况影响。
reeling_create_storyboard	生成结构化的多场景分镜脚本（时长从 30 秒到 5 分钟），并拆分为连续的 5 秒电影级镜头，附带音频／拟音提示。
reeling_stitch_storyboard	通过 Reeling 配置的视频工作流请求渲染并拼接各个场景。

---

🔑 开始使用

1. 获取 API 密钥：

   • 前往 reeling.app 并登录。
   • 转到 设置 → API 密钥。
   • 生成新密钥（以 rl_... 开头）。

2. 运行服务：

   npx -y github:yomariano/reeling-mcp#v1.1.0
   

   或使用安装指南连接到托管的 Streamable HTTP 端点 https://mcp.reeling.app/mcp。

---

💻 配置示例

1. Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "reeling": {
      "command": "npx",
      "args": ["-y", "github:yomariano/reeling-mcp#v1.1.0"],
      "env": {
        "REELING_API_KEY": "rl_your_live_api_key_here",
        "REELING_API_URL": "https://api.reeling.app"
      }
    }
  }
}

或直接从源码运行：

{
  "mcpServers": {
    "reeling": {
      "command": "node",
      "args": ["/absolute/path/to/reeling-mcp/bin/cli.js"],
      "env": {
        "REELING_API_KEY": "rl_your_live_api_key_here"
      }
    }
  }
}

2. Cursor IDE

在项目根目录中创建或编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "reeling": {
      "command": "npx",
      "args": ["-y", "github:yomariano/reeling-mcp#v1.1.0"],
      "env": {
        "REELING_API_KEY": "rl_your_live_api_key_here"
      }
    }
  }
}

3. Antigravity (AGY)

添加到 ~/.gemini/antigravity-cli/mcp_config.json 或项目 MCP 配置中：

{
  "mcpServers": {
    "reeling": {
      "command": "node",
      "args": ["/absolute/path/to/reeling-mcp/bin/cli.js"],
      "env": {
        "REELING_API_KEY": "rl_your_live_api_key_here"
      }
    }
  }
}

4. 远程托管的 SSE 服务（适用于 Grok Bot、Claude Remote、Web Agents）

你可以将 reeling-mcp 作为持久运行的服务器发送事件（SSE）服务，为远程 AI Agent 提供服务：

# Run locally or deploy to Railway / Render / VPS / Docker
npx -y github:yomariano/reeling-mcp#v1.1.0 --sse --port 3005

开放的端点：

• GET /health：健康检查状态。
• GET /sse：服务器发送事件连接流（通过客户端的密钥标头配置提供凭据）。
• POST /messages?sessionId=...：JSON-RPC 协议消息接收端点。

Grok Bot 配置（xAI）

添加到 Grok Bot 自定义 MCP 服务中：

• 传输方式：SSE
• 端点：https://mcp.reeling.app/sse（或 http://localhost:3005/sse）
• 标头：X-API-Key: rl_your_live_api_key_here

---

🤖 Agent 集成

托管服务会在 mcp.reeling.app/install 提供可安装套件和连接器元数据，适用于兼容 ChatGPT 的连接器、Claude 和 Grok。本地软件包适用于任何可启动 npm 软件包或连接 HTTP 传输的 MCP 客户端。

如需了解 API 级集成，请参阅 Reeling 开发者门户。如果你构建了其他 Reeling 用户可以复用的客户端、示例或平台适配器，请提交 issue。

---

🧪 本地测试

你可以使用 MCP 检查器手动测试 MCP 服务：

npx @modelcontextprotocol/inspector node bin/cli.js

或测试 SSE 模式：

node bin/cli.js --sse --port 3005
curl http://localhost:3005/health

---

📄 许可证

MIT © reeling.app

参与贡献

欢迎提交关于客户端兼容性、文档、示例和 MCP 传输安全改进的 issue 和拉取请求。请勿提交 API 密钥、包含密钥的生产环境 URL、客户数据或 Reeling 私有应用代码。报告漏洞前，请参阅仓库的安全策略。

可运行示例

克隆 reeling-examples，查看账号发现、经审核的视频请求、有限次数的投递状态轮询、分析数据获取和可编辑内容日历示例。请从离线模式开始。阅读示例指南。

架构

flowchart LR
  Client[Your MCP client] -->|stdio or HTTPS /mcp| Adapter[Reeling MCP adapter]
  Adapter -->|API key| API[Reeling REST API]
  API --> Queue[Publishing queue]
  Queue --> Channels[Authorized social channels]
  API -->|Per-destination state| Adapter

适配器会向 Reeling API 发送经过身份验证的请求。账号、套餐和平台权限决定了哪些操作可以执行。请在客户端中审核写入工具；仅凭工具结果或上传回执，无法确认内容已公开发布。

开发与发布

npm ci
npm test
npm run check
npm pack --dry-run

请参阅 CONTRIBUTING.md、CHANGELOG.md 和 GitHub releases。上述安装方式使用带版本号的 GitHub 标签；发布到 npm 需要单独进行经过身份验证的 npm 发布。

设置指南预览

公开开发者指南的本地预览。打开当前设置指南。