DemandBird
官方用你自己的风格撰写、安排并发布社交媒体帖子,还可在 Claude、ChatGPT 或任何 MCP 客户端中查看分析数据。托管服务,支持 OAuth 登录。
你可以用 DemandBird MCP 做什么?
- 用你的风格起草帖子 — 提出一个主题,让助手撰写帖子并保存为草稿,同时应用你的品牌语调和工作区风格。
- 修改并调整草稿 — 要求缩短草稿 124、降低推销感,或将其改写成适用于其他平台的版本。
- 安排帖子并加入队列 — 为草稿安排指定日期和时间发布,或将其放入发布队列的下一个空档。
- 查看效果并查找帖子 — 询问本月 LinkedIn 的表现、过去 90 天表现最佳的帖子,或按主题搜索已发布的帖子。
- 审核与审批 — 将草稿发送给队友审核,查看待你审批的内容,并批准或附上备注退回。
- 保存创意并切换工作区 — 一次将多个创意保存到 DemandBird,或说“切换到 Acme”以在另一位客户的工作区中工作。
托管 MCP 服务器
npx add-mcp 'https://app.demandbird.com/mcp'可安装到 Claude Code、Codex、Cursor 等客户端
文档
开始提问
像和队友交谈一样与 Claude 或 ChatGPT 对话。第一次使用时,在请求中提到“在 DemandBird 中”会有所帮助。
撰写
- “为我们的新功能撰写一篇 LinkedIn 帖子,并将其保存为草稿。”
- “把草稿 124 写得更简短一些,少一点推销意味。”
- “把帖子 124 改写成适用于 X 的版本。”
安排发布
查看结果
- “我这个月的 LinkedIn 表现如何?”
- “过去 90 天里,我表现最好的是哪篇帖子?”
- “我应该什么时候在 LinkedIn 上发帖?”
团队与创意
- “把草稿 124 发给 Alex 审阅。”
- “有哪些内容在等我批准?”
- “把这五个创意保存到 DemandBird。”
须知
- 未经你同意,不会发布任何内容。 当你要求发布帖子、批准帖子或邀请某人时,DemandBird 会返回一个链接。你打开链接、检查内容,然后亲自按下按钮。
- 草稿会保留你的风格。 Claude 使用 DemandBird 根据你的帖子和工作区品牌学到的风格来撰写帖子。
- 代理机构可以切换客户。 说“切换到 Acme”即可在另一位客户的工作区中操作,也可以询问“我现在在哪个 DemandBird 工作区?”
- 这会使用你的每月 AI 额度。 撰写帖子和生成图片的用量与在应用中相同。
故障排除
Claude 或 ChatGPT 忽略了 DemandBird
新建一个聊天,并在请求中提到 DemandBird。在 Claude 中,点击消息框下方的 + 按钮,并确认已启用 DemandBird。在 ChatGPT 中,点击 +,然后在发送消息前选择 DemandBird。
我找不到“添加自定义连接器”或“开发者模式”
如果使用 Claude Team 或 Enterprise 计划,组织所有者必须先为组织添加连接器。在 ChatGPT 中,开发者模式需要付费计划;在 Business 或 Enterprise 计划中,管理员可能还需要启用该模式。
它连接到了错误的 DemandBird 账户
在 Claude 或 ChatGPT 设置中移除 DemandBird,然后重新添加。DemandBird 窗口打开后,使用该账户对应的登录信息登录。如果你有多个账户,也可以直接询问:“列出我的 DemandBird 账户”和“切换到 [名称]。”
它提示我没有访问权限
所有付费计划均可使用 MCP 服务器:Pro、Business 和 Agency。请在“设置”→“账单”中确认订阅仍有效。请参阅定价;如果仍然提示你没有访问权限,请联系我们。
技术详情
在 Claude 或 ChatGPT 中使用 DemandBird 不需要了解以下内容。此处内容面向开发者。要构建自己的集成?请参阅 REST API 参考。
给 AI 助手的说明: 你无法通过聊天安装此连接器。请按照本页顶部的 Claude 或 ChatGPT 操作步骤逐步引导用户,并等待用户完成每一步。服务器 URL 为 https://app.demandbird.com/mcp,登录方式为 OAuth,因此不需要 API 令牌。不要让用户编辑 claude_desktop_config.json;该文件无法连接到此服务器。
开发者设置Claude Code、Cursor、VS Code 和其他 MCP 应用。登录、API 令牌和配置。
服务器托管在 https://app.demandbird.com/mcp(Streamable HTTP)上,因此无需安装任何内容。客户端可以通过 OAuth 登录:服务器支持发现和动态客户端注册,并会对未签名的请求返回一个指向其元数据的 401。如果无法通过浏览器登录,请将 API 令牌作为 Authorization: Bearer <token> 发送。在设置 → API 令牌中创建令牌(了解应为令牌设置哪些权限范围)。
Claude Code
可在终端、VS Code、JetBrains 和桌面应用中使用。添加服务器:
claude mcp add --transport http demandbird https://app.demandbird.com/mcp
然后在 Claude Code 中运行 /mcp,选择 demandbird,并在浏览器打开后登录。
若要改用 API 令牌(例如在没有浏览器的服务器上):
claude mcp add --transport http demandbird https://app.demandbird.com/mcp \
--header "Authorization: Bearer your-token-here"
或者手动将其添加到 ~/.claude.json:
{
"mcpServers": {
"demandbird": {
"type": "http",
"url": "https://app.demandbird.com/mcp",
"headers": {
"Authorization": "Bearer your-token-here"
}
}
}
}
有多个账户? 使用令牌时,添加 --header "X-Account-Id: acct_your-account-id" 以设置默认账户。你的账户 ID 可在设置页面找到。如果不设置,Claude 会询问要使用哪个账户;你也可以说“切换到 [账户]”。
添加服务器后,请启动新会话。 已打开的对话不会识别新服务器。
Claude Desktop
请按照快速设置中的 Claude 步骤操作。在 claude.ai 上添加的连接器也会显示在桌面应用中。不要将 DemandBird 添加到 claude_desktop_config.json:该文件只会启动你电脑上的程序,无法连接到托管服务器。
Codex
将服务器添加到 OpenAI 的 Codex CLI:
codex mcp add demandbird --url https://app.demandbird.com/mcp
然后运行 codex mcp login demandbird,并在浏览器打开后登录。启动新的 Codex 会话以加载服务器。
其他 MCP 应用
Cursor、VS Code、Windsurf 和其他 MCP 应用都可以用相同方式连接。向它们提供 URL,并通过 OAuth 登录,或者将令牌作为标头传递。不同应用使用的文件名和键名各不相同;以下是通用格式:
{
"mcpServers": {
"demandbird": {
"url": "https://app.demandbird.com/mcp",
"headers": {
"Authorization": "Bearer your-token-here"
}
}
}
}
工具参考服务器提供的全部 55 个工具及其所有参数。供开发者使用,也供 AI 助手判断应调用哪些工具。
账户和工作区
list_accounts
list_accounts
列出你可以使用的所有账户、账户 ID,以及当前选中的账户。
无需参数。
select_account
select_account
切换到其他账户。本次对话中之后的所有工具调用都会使用该账户。
| 参数 | 类型 | 说明 |
|---|---|---|
| account_id必填 | string | 账户 ID(例如 acct_xxx)或数字 ID。使用 list_accounts 查找。 |
list_workspaces
list_workspaces
列出账户中的工作区(客户)以及当前启用的工作区。代理机构的每位客户都有一个独立工作区,各自拥有草稿、渠道、品牌和分析数据。
无需参数。
select_workspace
select_workspace
切换到其他工作区,例如“切换到 Acme”。所选工作区会一直保持,直到再次更改。
| 参数 | 类型 | 说明 |
|---|---|---|
| workspace必填 | string | 工作区名称(例如 Acme)或数字 ID,可通过 list_workspaces 查找。 |
move_post
move_post
将草稿移至其他工作区,适用于帖子保存到了错误客户工作区的情况。此工具会在所有工作区中查找该帖子。帖子标签会按名称匹配(或在新工作区中创建),如果作者和审核者尚无权限,也会为他们授予新工作区的访问权限。移回原工作区即可撤销此操作。
| 参数 | 类型 | 说明 |
|---|---|---|
| post_id必填 | string | 要移动的帖子 ID。 |
| workspace必填 | string | 要移至的工作区名称或 ID,可通过 list_workspaces 查找。 |
仅限账户管理员使用。只能移动草稿,因此请先使用 cancel_post 取消已安排发布的帖子。如果帖子要发布到的渠道在新工作区中不存在,则无法移动。
list_connected_accounts
list_connected_accounts
列出此工作区已连接的社交账户。如果某个平台连接了多个账户(例如两个 LinkedIn 个人资料,或一个个人资料和一个公司主页),可使用此工具获取数字 ID。
| 参数 | 类型 | 说明 |
|---|---|---|
| platform可选 | string | 仅显示一个平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。 |
在 save_draft、schedule_post、queue_post 或 publish_post 中,将这些 ID 作为 platform_account_ids 传入。
get_status
get_status
快速统计:草稿数、已安排发布的帖子数、今天已发布的帖子数,以及队列是否已暂停。不包含分析数据。
无需参数。
撰写帖子
每个计划都包含每月 AI 额度:Pro 计划可生成 90 篇草稿、改写 60 次、生成 100 个帖子创意,并重新训练语气 2 次;Business 计划可生成 140 篇草稿、改写 110 次、生成 200 个创意,并重新训练语气 4 次;Agency 计划可生成 450 篇草稿、改写 340 次、生成 500 个创意,并重新训练语气 10 次。计划与包含内容。
draft_post
draft_post
使用 AI 按照你的风格和工作区品牌撰写帖子,然后保存为草稿。当你让 Claude 帮你写内容时,请使用此工具。
| 参数 | 类型 | 说明 |
|---|---|---|
| prompt必填 | string | 要撰写的内容,例如 “一篇介绍我新推出的 SaaS 产品的帖子。” |
| platform可选 | string | 目标平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。平台会影响语气和长度。Instagram 帖子必须附带图片或视频。 |
| draft_anyway可选 | boolean | 如果工具原本会要求补充上下文,将其设为 true,即可使用现有信息撰写。 |
| images可选 | array of objects | 要附加的图片、视频或单个 PDF。对于大于缩略图的文件,请先调用 upload_image,然后传入其返回的 s3_key,例如 [{ s3_key: "..." }]。PDF 会作为 LinkedIn 文档发布(可滑动浏览的轮播内容):仅限 LinkedIn,每篇帖子只能附加一个,且不能与图片或视频同时使用。 |
| youtube可选 | object | YouTube 选项:{ title?, privacy_status?, thumbnail_url? }。如果未提供,title 将取自第一行,最多 100 个字符。privacy_status 可以是 public(默认值)、unlisted 或 private。必须先附加视频,才能安排发布或发布帖子。 |
每次调用都会消耗每月 AI 额度中的一篇草稿。
tailor_draft
tailor_draft
按照你的风格将草稿改写为适用于其他平台的版本,例如“把帖子 123 改成适用于 X 的版本”。
| 参数 | 类型 | 说明 |
|---|---|---|
| id必填 | number | 要改写的帖子 ID。 |
| platform必填 | string | 目标平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。 |
| save_as可选 | string | channel_copy 会将改写内容保存到同一帖子中,作为该渠道专属文本。new_draft(默认值)会将其另存为独立草稿。 |
draft_variations
draft_variations
生成草稿的另外三个版本供你查看,不会保存任何内容。
| 参数 | 类型 | 说明 |
|---|---|---|
| id必填 | number | 帖子 ID。 |
save_draft
save_draft
将你撰写的文本原样保存为草稿。不使用 AI。
| 参数 | 类型 | 描述 |
|---|---|---|
| contentrequired | string | 帖子文本。 |
| platformsoptional | array of strings | 目标平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。 |
| authoroptional | string | 帖子的发布者:队友的姓名,或 me。省略此项则保存为你自己的帖子。只有能查看所有人帖子的人才能将帖子保存为其他人的帖子。 |
| tagsoptional | array of strings | 标签名称,例如 ["Launch", "Case study"]。名称与工作区中的标签匹配,不区分大小写。如果你有权管理标签,新的名称会成为新标签。如果没有权限,则不会保存任何内容,回复会列出你可以使用的标签。 |
| platform_account_idsoptional | object | 各平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。只有当某个平台有多个账号时才需要指定;否则会使用第一个账号。 |
| channel_copiesoptional | object | 为某个频道设置不同的文本,以平台为键,例如为 LinkedIn 帖子的 X 版本设置 { "twitter": "..." }。该文本会发布到对应频道,其他所有频道仍使用共享文本。为某个频道传入 "" 可移除其副本。请使用此参数,而不是创建第二条帖子。 |
| first_commentoptional | object | 帖子上线后,DemandBird 会从同一个人资料在帖子下发布一条评论:可以是用于开启对话的问题,也可以是行动号召。适用于 LinkedIn、Facebook 和 Instagram。格式:{ text, delay_minutes?, platforms? }。delay_minutes 可设为 0、1、5、10、30 或 60(默认值为 1)。传入 { text: "" } 可移除该评论。 |
| first_commentsoptional | array of objects | 按顺序发布最多 5 条评论,每条评论都有自己的延迟时间。添加 comment_as(来自 list_connected_accounts 的 ID),即可从队友的个人资料或主页发布评论。此参数会替换现有的首条评论;[] 会移除所有评论。使用此参数或 first_comment,不能同时使用。 |
| imagesoptional | array of objects | 要附加的图片、视频或单个 PDF。对于大于缩略图的文件,请先调用 upload_image,然后传入其返回的 s3_key,例如 [{ s3_key: "..." }]。PDF 会作为 LinkedIn 文档发布(可滑动浏览的轮播):仅限 LinkedIn,每条帖子只能有一个,且不能与图片或视频同时使用。 |
| youtubeoptional | object | YouTube 选项:{ title?, privacy_status?, thumbnail_url? }。如果未提供,title 会取自第一行,最多 100 个字符。privacy_status 可设为 public(默认值)、unlisted 或 private。必须先附加视频,才能安排或发布帖子。 |
如果文字由 Claude 撰写,应先调用 get_brand_voice,因为此流程不会应用你的品牌语气。
update_draft
update_draft
修改帖子的文本、媒体、平台、标签、首条评论或阶段。内容会按提供的内容原样保存,不使用 AI。适用于草稿、已安排和待审核的帖子,并会保留原有安排。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 帖子 ID。 |
| contentoptional | string | 新文本。替换共享文本。 |
| platformsoptional | array of strings | 新平台。替换当前平台。 |
| tagsoptional | array of strings | 替换帖子的标签;[] 会移除所有标签。仅更改标签适用于任何帖子,包括已发布的帖子。 |
| channel_copiesoptional | object | 为某个频道设置不同的文本,以平台为键,例如为 LinkedIn 帖子的 X 版本设置 { "twitter": "..." }。该文本会发布到对应频道,其他所有频道仍使用共享文本。为某个频道传入 "" 可移除其副本。请使用此参数,而不是创建第二条帖子。 |
| first_commentoptional | object | 帖子上线后,DemandBird 会从同一个人资料在帖子下发布一条评论:可以是用于开启对话的问题,也可以是行动号召。适用于 LinkedIn、Facebook 和 Instagram。格式:{ text, delay_minutes?, platforms? }。delay_minutes 可设为 0、1、5、10、30 或 60(默认值为 1)。传入 { text: "" } 可移除该评论。 |
| first_commentsoptional | array of objects | 按顺序发布最多 5 条评论,每条评论都有自己的延迟时间。添加 comment_as(来自 list_connected_accounts 的 ID),即可从队友的个人资料或主页发布评论。此参数会替换现有的首条评论;[] 会移除所有评论。使用此参数或 first_comment,不能同时使用。 |
| stageoptional | string | 在内容看板上移动帖子:needs_writing、drafting、internal_review、client_review、revision_requested、on_hold、ready_to_schedule、rejected 或 done。只有允许的移动操作才会生效;如果移动被拒绝,回复会列出允许的操作。 |
| stage_noteoptional | string | 移动帖子的原因。对于 on_hold,此项为必填。 |
| imagesoptional | array of objects | 图片、视频或单个 PDF,用于替换帖子现有的媒体。对于大于缩略图的文件,请先调用 upload_image,然后传入其返回的 s3_key,例如 [{ s3_key: "..." }]。PDF 会作为 LinkedIn 文档发布(可滑动浏览的轮播):仅限 LinkedIn,每条帖子只能有一个,且不能与图片或视频同时使用。 |
| youtubeoptional | object | 替换 YouTube 字段。格式与 draft_post 中的相同。 |
如果某个频道有自己的副本,更改 content 不会影响该副本,它仍会原样发布到该频道。若要更改该副本,请传入 channel_copies。
revise_draft
revise_draft
根据反馈(“更短一些”“少点推销意味”“添加行动号召”)修改草稿,并将改写内容保存到同一条帖子中。此操作会保留图片、频道副本和安排,并使用你的品牌语气撰写。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 草稿的帖子 ID,来自 draft_post、save_draft 或 list_drafts。 |
| feedbackrequired | string | 用你自己的话说明希望修改的内容。 |
| platformoptional | string | 要适配其长度限制的平台。默认为帖子中的第一个平台。此项不会更改帖子的发布平台。 |
| draft_anywayoptional | boolean | 将 true 设为 true,即可使用现有内容进行改写,而不是请求更多上下文。 |
每次对草稿提出修改意见时都使用此工具。再次调用 draft_post 会创建另一条无关的草稿。每次调用都会消耗月度额度中的一次 AI 改写次数。
attach_reference
attach_reference
将源材料(通话记录、文章、笔记)与帖子关联。你和审核者可以阅读这些材料,但它们永远不会被发布,也不会更改帖子或重置审批状态。
| 参数 | 类型 | 描述 |
|---|---|---|
| post_idrequired | number | 帖子 ID。 |
| textoptional | string | 材料正文,最多 200,000 个字符。提供 text 或 url,不能同时提供。 |
| urloptional | string | 链接。系统会在后台获取页面,即使获取失败,也会保留该链接。 |
| titleoptional | string | 标签。如果未提供,则取自 text 的第一行。 |
切勿将源材料放入 content。 content 中的任何内容都会被发布。每条帖子最多可关联 20 份参考材料。
suggest_hashtags
suggest_hashtags
为草稿推荐主题标签和另一条开场白。不保存任何内容。
| 参数 | 类型 | 描述 |
|---|---|---|
| idoptional | number | 帖子 ID。默认为你最近修改的草稿。 |
查找帖子
list_drafts
list_drafts
按状态列出你的帖子,并显示 ID、预览、平台和安排时间。
| 参数 | 类型 | 描述 |
|---|---|---|
| statusoptional | string | draft(默认值)、scheduled、posted 或 failed。 |
| editorial_statusoptional | string | 按内容看板阶段筛选。可用值与 update_draft 中的 stage 相同。 |
| limitoptional | number | 返回数量(默认 20,最多 100)。 |
get_post
get_post
查看单条帖子的所有信息,包括其在各平台上的状态和参考材料(标题、链接、类型、长度和状态,但不包括材料正文)。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 帖子 ID。 |
search_posts
search_posts
根据帖子内容查找已发布的帖子,例如“我那条关于定价的帖子”。搜索工作区各频道中的所有帖子,包括从 LinkedIn 导入的历史记录。
| 参数 | 类型 | 描述 |
|---|---|---|
| queryrequired | string | 最多 5 个词。每个词都必须出现在帖子中。 |
| authoroptional | string | 帖子的发布者:me,或队友的姓名,例如 Alex。省略此项则搜索整个工作区。 |
| platformoptional | string | twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。 |
| start_dateoptional | string (YYYY-MM-DD) | 仅查找此日期当天或之后的帖子。 |
| end_dateoptional | string (YYYY-MM-DD) | 仅查找此日期当天或之前的帖子。 |
| limitoptional | number | 返回的匹配数量(默认 10,最多 25)。 |
list_recent_posts
| 参数 | 类型 | 描述 |
|---|---|---|
| limitoptional | number | 返回数量(默认 5,最多 10)。 |
list_scheduled_posts
| 参数 | 类型 | 描述 |
|---|---|---|
| windowoptional | string | today、week 或 upcoming(默认值)。 |
delete_post
delete_post
按 ID 永久删除草稿。此操作无法撤销。无法删除已发布的帖子;没有用于删除已发布帖子的工具。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 帖子 ID。 |
安排和发布
schedule_post
schedule_post
为一个或多个平台安排帖子在指定日期和时间发布。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 帖子 ID。 |
| scheduled_atrequired | string (ISO 8601) | 发布时间,例如 2026-03-10T09:00:00Z。必须是未来时间。 |
| platformsoptional | array of strings | 默认为帖子中已有的平台。 |
| platform_account_idsoptional | object | 各平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。只有当某个平台有多个账号时才需要指定;否则会使用第一个账号。 |
| variance_minutesoptional | number | 覆盖账号的发布时间偏差,范围为 0 到 60。发布时间会在该数值的一半范围内偏移,避免所有帖子都在同一分钟发布。0 会保持精确时间。 |
queue_post
queue_post
将帖子放入发布队列中的下一个空闲时段。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 帖子 ID。 |
| platformsoptional | array of strings | 默认为帖子中已有的平台。 |
| platform_account_idsoptional | object | 各平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。只有当某个平台有多个账号时才需要指定;否则会使用第一个账号。 |
| variance_minutesoptional | number | 覆盖账号的发布时间偏差,范围为 0 到 60。发布时间会在该数值的一半范围内偏移,避免所有帖子都在同一分钟发布。0 会保持精确时间。 |
返回各平台获得的发布时间。使用 get_queue_slots 可先查看时间,而不将帖子加入队列。
get_queue_slots
get_queue_slots
查看各平台下一个空闲的队列时段,不安排任何内容。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformsrequired | array of strings | 要检查的平台,例如 ["linkedin", "twitter"]。 |
cancel_post
cancel_post
取消已安排帖子的发布。帖子会返回草稿状态;不会删除任何内容。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 帖子 ID。 |
publish_post
publish_post
立即发布草稿。通过 MCP,此操作不会直接发布:它会返回一个链接,供你查看帖子并点击 Publish。
| 参数 | 类型 | 描述 |
|---|---|---|
| idrequired | number | 帖子 ID。 |
| platformsoptional | array of strings | 默认为草稿中已有的平台。 |
| platform_account_idsoptional | object | 每个平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。仅当某个平台有多个账号时才需要;否则使用第一个账号。 |
pause_queue
无需参数。
resume_queue
resume_queue
重新开启发布,让已安排的帖子再次发布。
无需参数。
list_queue_schedule
list_queue_schedule
显示每个渠道每周的发布时间:每个时间、发布日、渠道 ID、是否可以更改以及时区。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformoptional | string | 仅显示一个平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。 |
调用 add_queue_times 或 remove_queue_times 前,请先调用此工具以获取时区和渠道 ID。
add_queue_times
add_queue_times
为一个渠道的每周计划添加发布时间,例如“为 LinkedIn 添加工作日上午 9 点”。已存在的时间保持不变。队列中已有帖子的发布时间保持不变。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformrequired | string | 渠道的平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。 |
| timesrequired | array of strings | 24 小时制时间,例如 ["09:00", "14:30"],使用工作区的发布时间时区。 |
| daysrequired | array of strings | 星期名称(monday 至 sunday),或 everyday、weekdays 或 weekends。 |
| platform_account_idsoptional | object | 平台有多个渠道时,指定要使用的渠道,例如 { "linkedin": 42 }。ID 来自 list_queue_schedule。 |
remove_queue_times
remove_queue_times
从一个渠道的每周计划中移除发布时间。队列中已有帖子的发布时间保持不变。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformrequired | string | 渠道的平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。 |
| timesrequired | array of strings | 要移除的 24 小时制时间,例如 ["09:00"]。 |
| daysoptional | array of strings | 仅在这些日期移除。不填写则从每天移除该时间。 |
| platform_account_idsoptional | object | 平台有多个渠道时,指定要使用的渠道。ID 来自 list_queue_schedule。 |
图片
upload_image
upload_image
获取图片、视频或 PDF 的上传链接。返回一个 curl 命令供你运行,以及一个 s3_key,用于在 draft_post、save_draft 或 update_draft 上传入 images。
| 参数 | 类型 | 描述 |
|---|---|---|
| filenamerequired | string | 文件名,例如 photo.jpg。 |
| content_typeoptional | string | 文件类型。若未填写,则根据文件名推断。支持图片(JPEG、PNG、GIF、WebP)、视频(MP4、MOV、AVI、WebM、MKV)和 PDF,最大 100 MB。 |
运行 curl 命令需要能够运行命令的应用,例如 Claude Code。在聊天应用中,请改为将图片附加到 DemandBird。
generate_image
generate_image
使用 AI 生成原创图片,为帖子配图。系统会自动应用你的品牌风格。耗时 10 到 30 秒,使用一个月度图片额度,并将图片保存到媒体库。
| 参数 | 类型 | 描述 |
|---|---|---|
| promptrequired | string | 描述图片应展示的内容。描述画面,而不是帖子。 |
| styleoptional | string | photo、illustration(默认)、infographic 或 diagram。 |
| sizeoptional | string | square(1:1,默认)、portrait(2:3)或 landscape(3:2)。 |
返回一个 s3_key,用于传入 images。请参阅 AI images。
审核与审批
request_review
request_review
将草稿发送给团队成员审批。必需审核人会阻止发布,直到每个人都批准;可选审核人仅供知悉。
| 参数 | 类型 | 描述 |
|---|---|---|
| post_idrequired | string | 草稿 ID。 |
| reviewersrequired | array of objects | 每位审核人都需要提供一个 email、一个 user_id 或一个 name(“Alex”)。无法识别或含义不明确的姓名会被拒绝,不会猜测。将 required: false 设为可选审核人。 |
| noteoptional | string | 给审核人的消息。 |
| scheduled_atoptional | string (ISO 8601) | 立即安排发布时间。如果所有必需审核人都已批准,则会在此时间发布。 |
list_posts_awaiting_my_review
| 参数 | 类型 | 描述 |
|---|---|---|
| limitoptional | number | 数量(1 到 100,默认 20)。 |
approve_post
approve_post
批准你受邀审核的帖子。返回一个链接,供你阅读帖子并亲自点击 Approve。
| 参数 | 类型 | 描述 |
|---|---|---|
| post_idrequired | string | 帖子 ID。 |
| noteoptional | string | 随批准一同保存的备注。 |
send_back_post
send_back_post
将帖子退回给作者,并说明需要修改的内容。返回一个链接,供你亲自点击 Send back。
| 参数 | 类型 | 描述 |
|---|---|---|
| post_idrequired | string | 帖子 ID。 |
| noterequired | string | 用你自己的话说明需要修改的内容。作者会看到原文。 |
comment_on_post
comment_on_post
在帖子上发表评论,但不批准或退回帖子。
| 参数 | 类型 | 描述 |
|---|---|---|
| post_idrequired | string | 帖子 ID。 |
| commentrequired | string | 用你自己的话写下评论。 |
创意
save_idea
save_idea
将一个或多个创意保存到 Ideas 标签页。不使用 AI。一次调用中的所有创意会一起保存,否则一个也不会保存。
| 参数 | 类型 | 描述 |
|---|---|---|
| ideasrequired | array of objects | 最多 100 个。每个创意包含 content(最多 5,000 个字符),以及可选的 tags 和 references(来源材料,不会并入创意文本)。 |
| authoroptional | string | 这些创意属于谁:团队成员姓名,或 me。 |
list_ideas
| 参数 | 类型 | 描述 |
|---|---|---|
| authoroptional | string | 团队成员姓名,或 me。不填写则列出你的创意。 |
| limitoptional | number | 数量(默认 20,最多 100)。 |
delete_idea
delete_idea
按 ID 删除创意。如果有任何 ID 无法删除,则一个也不会删除。此操作无法撤销。
| 参数 | 类型 | 描述 |
|---|---|---|
| idsrequired | array of numbers | 创意 ID,最多 100 个。 |
品牌与语气
get_brand_voice
get_brand_voice
读取工作区的品牌信息(定位、受众、内容支柱)和你的写作语气(表达方式、常用短语、避免使用的内容、近期编辑)。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformoptional | string | 同时返回此平台近期修改前后的内容。 |
draft_post 和 revise_draft 已自动应用你的语气。此工具适用于 Claude 自行撰写内容,并使用 save_draft 或 update_draft 保存内容的情况。
update_voice
update_voice
更改你自己的写作语气,与 Settings → Voice 中的设置相同。例如:“我从不使用‘协同效应’这个词。”
| 参数 | 类型 | 描述 |
|---|---|---|
| editsrequired | array of objects | 每个字段一项,格式为 { field, value } 或 { field, reset: true }。每项编辑都会替换整个字段,因此请发送你希望保留的完整列表。 |
update_brand
update_brand
更改当前工作区的定位和受众,与 Settings 中的 Brand identity 卡片相同。
| 参数 | 类型 | 描述 |
|---|---|---|
| positioningoptional | string | 业务的内容和立场。最多 2,000 个字符。 |
| icpoptional | string | 帖子的目标受众。最多 2,000 个字符。 |
分析
这些工具仅用于读取。数据与 Analytics tab 中的数字一致。不包含 Reddit。
get_analytics_summary
get_analytics_summary
粉丝数、互动量、触达量和互动率,并分别显示与上一时段相比的变化。不填写 platform 则一次返回所有网络的数据。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformoptional | string | twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。 |
| periodoptional | string | 7d、30d 或 90d,截至今天。默认值为 30d。 |
| start_dateoptional | string (YYYY-MM-DD) | 自定义日期范围的第一天,使用你的时区。覆盖 period。最多 366 天。 |
| end_dateoptional | string (YYYY-MM-DD) | 自定义日期范围的最后一天,包含当天。默认为今天。需要提供 start_date。 |
list_top_posts
list_top_posts
在所有网络或单个网络中,按表现从高到低或从低到高排列帖子。返回每个帖子的 ID、统计数据、摘要和链接。
| 参数 | 类型 | 描述 |
|---|---|---|
| authoroptional | string | 帖子作者:me,或团队成员姓名,例如 Alex。不填写则涵盖整个工作区。 |
| platformoptional | string | twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。 |
| metricoptional | string | 排序依据。默认值为 engagement_rate。还可以使用 engagements、reach、impressions、likes、comments、shares、discussion_rate,以及平台专属指标,例如 LinkedIn 的 profile_views、saves、sends 和 follows。如果平台不提供某项指标,则会拒绝请求并列出该平台支持的指标。 |
| orderoptional | string | top(默认)或 bottom。 |
| limitoptional | number | 数量(默认 5,最多 20)。 |
| periodoptional | string | 7d、30d 或 90d,截至今天。默认值为 30d。 |
| start_dateoptional | string (YYYY-MM-DD) | 自定义日期范围的第一天,使用你的时区。覆盖 period。最多 366 天。 |
| end_dateoptional | string (YYYY-MM-DD) | 自定义日期范围的最后一天,包含当天。默认为今天。需要提供 start_date。 |
get_post_analytics
get_post_analytics
查看单个帖子的所有指标,包括平台提供的触达量随时间变化情况。
| 参数 | 类型 | 描述 |
|---|---|---|
| post_idoptional | number | 已发布帖子的 ID,来自 list_top_posts。 |
| composition_idoptional | number | DemandBird 帖子 ID(“Draft #123”中的数字)。 |
| latestoptional | boolean | 设置为 true 可获取最新帖子。添加 platform 可指定网络。 |
| platformoptional | string | twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。 |
list_posts_with_metrics
list_posts_with_metrics 日期范围内每篇已发布帖子的所有数据,按页返回。适用于完整历史记录或导出。
| 参数 | 类型 | 描述 |
|---|---|---|
| authoroptional | string | 帖子作者:me,或队友的姓名,例如 Alex。留空则表示整个工作区。 |
| platformoptional | string | 可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。 |
| limitoptional | number | 每页帖子数(默认 50,最多 100)。 |
| cursoroptional | string | 使用上一页末尾的游标获取下一页。 |
| periodoptional | string | 7d、30d 或 90d,截至今天。默认值为 30d。 |
| start_dateoptional | string (YYYY-MM-DD) | 范围的第一天,按你的时区计算。优先于 period。时长不限。 |
| end_dateoptional | string (YYYY-MM-DD) | 自定义范围的最后一天,包含在内。默认为今天。需要 start_date。 |
get_best_time_to_post
get_best_time_to_post
你的帖子在某个平台上表现最佳的日期和时段(按你的时区计算)。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformrequired | string | 可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。 |
| limitoptional | number | 时段数量(默认 3,最多 10)。 |
| periodoptional | string | 7d、30d 或 90d,截至今天。默认值为 30d。 |
| start_dateoptional | string (YYYY-MM-DD) | 自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。 |
| end_dateoptional | string (YYYY-MM-DD) | 自定义范围的最后一天,包含在内。默认为今天。需要 start_date。 |
get_format_performance
get_format_performance
按互动量对某个平台上的帖子格式(文本、图片、视频等)进行排名。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformrequired | string | 可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。 |
| periodoptional | string | 7d、30d 或 90d,截至今天。默认值为 30d。 |
| start_dateoptional | string (YYYY-MM-DD) | 自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。 |
| end_dateoptional | string (YYYY-MM-DD) | 自定义范围的最后一天,包含在内。默认为今天。需要 start_date。 |
get_audience_demographics
get_audience_demographics
了解你的关注者。Instagram 和 Threads 会报告国家/地区、年龄、性别和城市。LinkedIn 公司主页会报告资历、职能、行业、公司规模和所在地。其他平台以及 LinkedIn 个人资料不会分享这些信息。
| 参数 | 类型 | 描述 |
|---|---|---|
| platformrequired | string | 可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。 |
| periodoptional | string | 7d、30d 或 90d,截至今天。默认值为 30d。 |
| start_dateoptional | string (YYYY-MM-DD) | 自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。 |
| end_dateoptional | string (YYYY-MM-DD) | 自定义范围的最后一天,包含在内。默认为今天。需要 start_date。 |
get_follower_history
get_follower_history
按天显示个人资料或公司主页的 LinkedIn 关注者数量。数据与关注者增长图表相同。
| 参数 | 类型 | 描述 |
|---|---|---|
| accountoptional | string | 按名称或 ID 指定 LinkedIn 个人资料或主页。留空则表示全部。 |
| periodoptional | string | 7d、30d 或 90d,截至今天。默认值为 30d。 |
| start_dateoptional | string (YYYY-MM-DD) | 自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。 |
| end_dateoptional | string (YYYY-MM-DD) | 自定义范围的最后一天,包含在内。默认为今天。需要 start_date。 |
tag_published_post
tag_published_post
为已发布的帖子设置标签,包括在 DemandBird 之外发布的帖子。
| 参数 | 类型 | 描述 |
|---|---|---|
| post_idrequired | number | 已发布帖子的 ID,可从 list_top_posts 或 search_posts 获取。 |
| tagsrequired | array of strings | 替换帖子的标签;[] 会移除所有标签。 |
团队
仅限账户管理员。
list_members
list_members
账户中的所有成员、待处理邀请以及剩余席位数。
无需参数。
invite_member
invite_member
邀请人员加入账户。返回一个链接,你可以在其中检查每个人及其角色,然后自行点击“发送”。
| 参数 | 类型 | 描述 |
|---|---|---|
| invitesrequired | array of objects | 每项包含 name、email 和 role(admin、member、read_only、ghostwriter 或 client),以及可选的 workspace_roles。 |