Chirpie

@chirpie/mcp

面向 AI Agent 的发布连接器。 Chirpie 提供一个 API，可在 X/Twitter、Bluesky、LinkedIn、Threads、Mastodon、Instagram、Facebook 和 Telegram 上发布内容、串帖和安排发布，涵盖发布、串帖、定时发布、草稿、删除和分析。这个 MCP 服务将所有这些功能提供给 Claude、Cursor、ChatGPT 或任何兼容 MCP 的 Agent，因此，“把这条内容发到 X 和 LinkedIn，并安排在上午 9 点发布后续内容”只需一句话，无需一堆平台 SDK、繁琐的 OAuth 流程和速率限制处理。

托管服务（推荐）

你无需安装任何东西。将客户端指向：

https://chirpie.ai/mcp

按提示登录即可连接。无需复制 API 密钥，也无需操心更新。

Claude Code

claude mcp add --transport http chirpie https://chirpie.ai/mcp

Claude：从 Claude Connectors Directory 添加 Chirpie，或依次选择 Customize → Connectors → + → Add custom connector → https://chirpie.ai/mcp（指南）

Cursor：添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "chirpie": {
      "url": "https://chirpie.ai/mcp"
    }
  }
}

ChatGPT（网页版，开发者模式）：Settings → Apps → Create → MCP server URL https://chirpie.ai/mcp → OAuth → Scan Tools（指南）

如果你更喜欢使用密钥而非 OAuth（例如用于 CI、脚本或不支持 OAuth 流程的客户端），请将密钥作为标头发送：

{
  "mcpServers": {
    "chirpie": {
      "type": "http",
      "url": "https://chirpie.ai/mcp",
      "headers": { "Authorization": "Bearer chirpie_sk_your_key_here" }
    }
  }
}

本地服务（此软件包）

通过 stdio 在本地运行同一组工具。

npm install -g chirpie
chirpie login

Claude Code

claude mcp add chirpie -- npx @chirpie/mcp

Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "chirpie": {
      "command": "npx",
      "args": ["@chirpie/mcp"]
    }
  }
}

Cursor：添加到 MCP 设置中：

{
  "mcpServers": {
    "chirpie": {
      "command": "npx",
      "args": ["@chirpie/mcp"]
    }
  }
}

本地服务按以下顺序解析凭据：

1. CHIRPIE_API_KEY 环境变量
2. ~/.chirpie/config.json（由 chirpie login 写入）

CLI 和此服务共用该配置，因此只需执行一次 chirpie login 即可同时用于两者。

工具

工具	功能
chirpie_upload_media	上传图片或视频，并获取帖子可附加的 ID。idempotency_key 可确保重试安全
chirpie_post	立即发布或定时发布到任意已连接的账号，也可以同时发布到多个账号。configuration 可将内容发布为快拍或短视频，而不是信息流帖子；timezone 可在 schedule_at 未指定偏移量时，按 IANA 时区解析；idempotency_key 可确保重试安全；draft 则会保存为草稿
chirpie_thread	发布由 2 至 25 部分组成的串文，可发到一个或多个账号。也接受 timezone 和 idempotency_key；draft 则会保存为草稿
chirpie_list_posts	列出帖子，可按状态、账号或多账号发布组筛选
chirpie_get_post	获取单个帖子
chirpie_update_post	编辑尚未发布的帖子，或完成草稿并安排发布或立即发布。configuration 可更改发布位置
chirpie_retry_first_comment	重新发布未能成功发布的首条评论。idempotency_key 可确保重试安全
chirpie_delete_post	从平台删除帖子。Chirpie 会保留该帖子，并标记为已删除
chirpie_hide_post	在 Chirpie 列表中隐藏帖子。不会对平台进行任何操作
chirpie_unhide_post	将隐藏的帖子恢复到列表中
chirpie_list_accounts	列出已连接的社交账号，包括活跃和非活跃账号
chirpie_activate_account	激活账号，使其可以发布内容
chirpie_deactivate_account	停用账号（保持连接，并释放一个套餐名额）
chirpie_disconnect_account	断开账号连接（结束连接、取消该账号的定时帖子，并释放一个套餐名额）
chirpie_analytics	获取已发布帖子的互动指标。refresh 会立即向平台查询，而不是读取已存储的快照；每个帖子每 5 分钟可查询一次
chirpie_create_key	创建 API 密钥；可选择使用 scopes 缩小权限范围，使其权限低于你的密钥
chirpie_list_keys	列出 API 密钥
chirpie_revoke_key	撤销 API 密钥
chirpie_connect_x	连接 X/Twitter（返回授权链接）
chirpie_connect_linkedin	连接 LinkedIn 个人资料
chirpie_connect_linkedin_pages	连接你管理的 LinkedIn Pages（即将推出）
chirpie_connect_threads	连接 Threads
chirpie_connect_instagram	连接 Instagram，via 可设为 instagram（默认值）或 facebook
chirpie_connect_facebook	连接 Facebook Page
chirpie_connect_bluesky	使用应用专用密码连接 Bluesky
chirpie_connect_mastodon	连接任意实例上的 Mastodon
chirpie_connect_telegram	连接 Telegram 机器人
chirpie_set_x_keys	注册你自己的 X 开发者应用，以便连接 X 账号
chirpie_get_x_keys_status	检查你自己的 X 开发者应用是否已配置
chirpie_remove_x_keys	移除你自己的 X 开发者应用

托管服务和本地服务提供的工具完全相同。在托管服务上， chirpie_create_key、chirpie_list_keys、chirpie_revoke_key 和 chirpie_remove_x_keys 需要使用 API 密钥进行身份验证。使用 OAuth 登录时不会提供这些工具，因为 OAuth 连接不得留下长期有效的密钥，也不得拆除其他连接所依赖的凭据。

哪些工具会在运行前询问？

每个工具都带有标题和标准 MCP 工具注释 （readOnlyHint、destructiveHint、idempotentHint、openWorldHint），因此客户端能在调用运行前了解其作用。列出和读取工具均为只读。删除帖子或评论、断开或停用账户、编辑排队中的帖子、撤销密钥，以及设置或移除自己的 X 应用均具有破坏性；除非你已授权，否则 Claude 等客户端会在运行前询问。 隐藏、取消隐藏和激活都不属于上述情况：每项操作都有精确的撤销方式。创建类工具不会标记为幂等：只有传入 idempotency_key 的工具，才能通过重试确保安全。若不传入密钥，重复调用 chirpie_post、chirpie_thread、chirpie_reply_to_comment 或 chirpie_retry_first_comment 可能会发布两次；重复调用 chirpie_upload_media 则会存储第二份副本，并在未使用的情况下过期。

一次调用多个账户

chirpie_post 和 chirpie_thread 使用 account_ids 代替 account_id，最多可传入 25 个账户。返回结果为一个 group_id，以及每个账户各自的结果，顺序与账户传入顺序一致；account_configurations 可为单个账户指定各自的文本、媒体或帖子串。即使某个平台拒绝发布，已成功的账户仍会保持已发布状态，因此 Agent 应检查每个结果中的 success。将 group_id 传给 chirpie_list_posts，即可读取整个组的内容。

首条评论

chirpie_post 和 chirpie_thread 支持 first_comment，即帖子发布时随帖发布的评论。对于帖子串，整条帖子串只有一条评论，会发布在最后一部分下方。仅支持 X、Threads、Instagram 和 Facebook：在其他平台上调用时会返回 400 first_comment_unsupported，而不是直接丢弃评论。该评论会计为每月配额中的一条帖子。

在多账户调用中，除非对应账户的 account_configurations 条目另有说明，否则所有账户都会收到共享的 first_comment：如果某个条目指定了 first_comment，就会替换该账户的共享评论；如果设置为 "first_comment": ""，则该账户发布时不附带评论。这样，一次调用即可向支持首条评论的平台账户发送评论，同时仍能在不支持该功能的平台账户发布帖子。

每条帖子都会返回 first_comment，其值为 null 或 { text, status, comment_id, error }，其中 status 为 pending、posted 或 failed。首条评论发布失败不会导致帖子发布失败，因此已发布的帖子可能附带一条未能发出的评论：chirpie_retry_first_comment 可重新发送该评论，chirpie_update_post 可修改评论文本，或在文本为空字符串时移除评论。

快拍、Reel 和其他发布选项

chirpie_post、chirpie_thread 和 chirpie_update_post 接受 configuration，即按平台指定的发布选项。Instagram 支持发布到 feed、story 或 reel，Facebook Page 支持发布到 feed 或 story。省略此项时，所有内容都会发布到 feed。

{
  "account_id": "...",
  "text": "Three minutes on how we schedule posts.",
  "media_ids": ["..."],
  "configuration": {
    "instagram": {
      "placement": "reel",
      "video_cover_timestamp_ms": 1500,
      "collaborators": ["a_co_author"],
      "share_to_feed": true
    }
  }
}

每种发布位置都有各自的选项：

• instagram feed：最多 10 张图片、collaborators（最多 3 个用户名） 和 user_tags，其中每项都需要同时包含 x 和 y。
• instagram story：恰好一张图片或一个视频，不支持说明文字（发送空 文本）、首条评论或协作者。user_tags 可以包含坐标，也可以省略坐标。
• instagram reel：恰好一个视频且不包含图片，此外还支持 collaborators、 user_tags（仅填写用户名，因为 Instagram 只会读取图片和快拍上的坐标）、 cover 或 video_cover_timestamp_ms（不能同时使用两者）、share_to_feed 和 trial_reel。
• facebook feed：link，显示为预览。
• facebook story：恰好一张图片或一个视频，不支持文本、首条评论或链接。

不会悄悄丢弃任何内容：如果平台对应的配置块不支持任何选项，或所选发布位置 不支持某个字段，系统会拒绝请求，并返回 400 configuration_unsupported， 指出平台和字段名称。快拍和 Reel 都是单条帖子，因此 chirpie_thread 会拒绝 这两种发布位置。对于多账户调用，同一平台的所有账户共用一个配置块；如果 account_configurations 条目中为某个账户指定了自己的 configuration，则会 覆盖该账户的配置。在 chirpie_update_post 中，如果省略 configuration， 帖子会保留已有选项；而 "configuration": {} 会将其恢复为普通 feed 帖子。

Instagram 账户有两种连接方式，chirpie_connect_instagram 通过 via 选择： instagram（默认值）通过 Instagram 登录；facebook 通过 Facebook 登录， 并连接用户分享的各个 Pages 关联的 Instagram 账户，可一次连接多个账户。无论 使用哪种发布位置，两种方式的发布效果都相同。唯一的区别是删除已发布的帖子： 通过 Facebook 连接的账户可以删除帖子，而通过 Instagram 连接的账户会被拒绝， 并返回 501 delete_unsupported。如果账户已通过另一种方式连接，再次连接会将 该账户迁移至新方式，而不是添加第二个账户：账户 ID 和所有已发布内容都会保留， 只有删除权限会改变。如果两种方式返回的 Instagram 账户不同，系统会新增第二个 账户，因此请之后重新列出账户。

草稿

在 chirpie_post 或 chirpie_thread 中设置 draft: true 会保存内容但不发送： 不会调用平台，不消耗配额，草稿也不会自动发布。草稿的限制比帖子宽松得多， 因此文本可以为空，草稿线程也可以只有一个部分；返回结果中还会包含 warnings 列表，按账户说明如果照当前内容发送会出现什么问题。

使用 chirpie_update_post 将草稿转为正式发布：schedule_at 会将其加入发布 队列，publish: true 会立即发送，两者不能同时使用。转为正式发布时会执行 创建帖子时的所有规则并消耗配额，因此任何拒绝都会使草稿保持原样。

试试看

连接后，可以向你的 Agent 提出以下请求：

• “发布到 X 和 LinkedIn：我们刚发布了 v2，但 X 上的内容要短一些。”
• “起草一个 5 帖的线程，讲讲我们为什么弃用了 cron，并安排在明天上午 9 点发布。”
• “我最近那条 Bluesky 帖子的表现如何？”
• “将其保存为草稿，我明天再确定措辞。”
• “连接我的 X 账户。”

Kiro power

此仓库的根目录也是 Agent Plugins 格式的 Kiro power： plugin.json 用于命名它并列出可激活它的关键词，mcp.json 指向托管服务 https://chirpie.ai/mcp。首次运行工具时，你会在浏览器中登录 Chirpie， 因此无需粘贴 API 密钥。

链接

• 文档：https://chirpie.ai/docs/mcp?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• API 参考：https://chirpie.ai/docs?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• 控制面板：https://chirpie.ai/dashboard?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• 隐私政策：https://chirpie.ai/privacy?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• 服务条款：https://chirpie.ai/terms?utm_source=npm&utm_medium=readme&utm_campaign=mcp
• 支持：https://chirpie.ai/support?utm_source=npm&utm_medium=readme&utm_campaign=mcp 或 [email protected]

MIT © Fireflo LLC

---

此仓库是 Chirpie monorepo 中 packages/mcp 的自动维护源镜像。在此处提交的拉取请求无法合并。