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可选objectYouTube 选项:{ 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可选stringchannel_copy 会将改写内容保存到同一帖子中,作为该渠道专属文本。new_draft(默认值)会将其另存为独立草稿。

draft_variations

draft_variations

生成草稿的另外三个版本供你查看,不会保存任何内容。

参数类型说明
id必填number帖子 ID。

save_draft

save_draft

将你撰写的文本原样保存为草稿。不使用 AI。

参数类型描述
contentrequiredstring帖子文本。
platformsoptionalarray of strings目标平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。
authoroptionalstring帖子的发布者:队友的姓名,或 me。省略此项则保存为你自己的帖子。只有能查看所有人帖子的人才能将帖子保存为其他人的帖子。
tagsoptionalarray of strings标签名称,例如 ["Launch", "Case study"]。名称与工作区中的标签匹配,不区分大小写。如果你有权管理标签,新的名称会成为新标签。如果没有权限,则不会保存任何内容,回复会列出你可以使用的标签。
platform_account_idsoptionalobject各平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。只有当某个平台有多个账号时才需要指定;否则会使用第一个账号。
channel_copiesoptionalobject为某个频道设置不同的文本,以平台为键,例如为 LinkedIn 帖子的 X 版本设置 { "twitter": "..." }。该文本会发布到对应频道,其他所有频道仍使用共享文本。为某个频道传入 "" 可移除其副本。请使用此参数,而不是创建第二条帖子。
first_commentoptionalobject帖子上线后,DemandBird 会从同一个人资料在帖子下发布一条评论:可以是用于开启对话的问题,也可以是行动号召。适用于 LinkedIn、Facebook 和 Instagram。格式:{ text, delay_minutes?, platforms? }。delay_minutes 可设为 0、1、5、10、30 或 60(默认值为 1)。传入 { text: "" } 可移除该评论。
first_commentsoptionalarray of objects按顺序发布最多 5 条评论,每条评论都有自己的延迟时间。添加 comment_as(来自 list_connected_accounts 的 ID),即可从队友的个人资料或主页发布评论。此参数会替换现有的首条评论;[] 会移除所有评论。使用此参数或 first_comment,不能同时使用。
imagesoptionalarray of objects要附加的图片、视频或单个 PDF。对于大于缩略图的文件,请先调用 upload_image,然后传入其返回的 s3_key,例如 [{ s3_key: "..." }]。PDF 会作为 LinkedIn 文档发布(可滑动浏览的轮播):仅限 LinkedIn,每条帖子只能有一个,且不能与图片或视频同时使用。
youtubeoptionalobjectYouTube 选项:{ title?, privacy_status?, thumbnail_url? }。如果未提供,title 会取自第一行,最多 100 个字符。privacy_status 可设为 public(默认值)、unlisted 或 private。必须先附加视频,才能安排或发布帖子。

如果文字由 Claude 撰写,应先调用 get_brand_voice,因为此流程不会应用你的品牌语气。

update_draft

update_draft

修改帖子的文本、媒体、平台、标签、首条评论或阶段。内容会按提供的内容原样保存,不使用 AI。适用于草稿、已安排和待审核的帖子,并会保留原有安排。

参数类型描述
idrequirednumber帖子 ID。
contentoptionalstring新文本。替换共享文本。
platformsoptionalarray of strings新平台。替换当前平台。
tagsoptionalarray of strings替换帖子的标签;[] 会移除所有标签。仅更改标签适用于任何帖子,包括已发布的帖子。
channel_copiesoptionalobject为某个频道设置不同的文本,以平台为键,例如为 LinkedIn 帖子的 X 版本设置 { "twitter": "..." }。该文本会发布到对应频道,其他所有频道仍使用共享文本。为某个频道传入 "" 可移除其副本。请使用此参数,而不是创建第二条帖子。
first_commentoptionalobject帖子上线后,DemandBird 会从同一个人资料在帖子下发布一条评论:可以是用于开启对话的问题,也可以是行动号召。适用于 LinkedIn、Facebook 和 Instagram。格式:{ text, delay_minutes?, platforms? }。delay_minutes 可设为 0、1、5、10、30 或 60(默认值为 1)。传入 { text: "" } 可移除该评论。
first_commentsoptionalarray of objects按顺序发布最多 5 条评论,每条评论都有自己的延迟时间。添加 comment_as(来自 list_connected_accounts 的 ID),即可从队友的个人资料或主页发布评论。此参数会替换现有的首条评论;[] 会移除所有评论。使用此参数或 first_comment,不能同时使用。
stageoptionalstring在内容看板上移动帖子:needs_writing、drafting、internal_review、client_review、revision_requested、on_hold、ready_to_schedule、rejected 或 done。只有允许的移动操作才会生效;如果移动被拒绝,回复会列出允许的操作。
stage_noteoptionalstring移动帖子的原因。对于 on_hold,此项为必填。
imagesoptionalarray of objects图片、视频或单个 PDF,用于替换帖子现有的媒体。对于大于缩略图的文件,请先调用 upload_image,然后传入其返回的 s3_key,例如 [{ s3_key: "..." }]。PDF 会作为 LinkedIn 文档发布(可滑动浏览的轮播):仅限 LinkedIn,每条帖子只能有一个,且不能与图片或视频同时使用。
youtubeoptionalobject替换 YouTube 字段。格式与 draft_post 中的相同。

如果某个频道有自己的副本,更改 content 不会影响该副本,它仍会原样发布到该频道。若要更改该副本,请传入 channel_copies。

revise_draft

revise_draft

根据反馈(“更短一些”“少点推销意味”“添加行动号召”)修改草稿,并将改写内容保存到同一条帖子中。此操作会保留图片、频道副本和安排,并使用你的品牌语气撰写。

参数类型描述
idrequirednumber草稿的帖子 ID,来自 draft_post、save_draft 或 list_drafts。
feedbackrequiredstring用你自己的话说明希望修改的内容。
platformoptionalstring要适配其长度限制的平台。默认为帖子中的第一个平台。此项不会更改帖子的发布平台。
draft_anywayoptionalboolean将 true 设为 true,即可使用现有内容进行改写,而不是请求更多上下文。

每次对草稿提出修改意见时都使用此工具。再次调用 draft_post 会创建另一条无关的草稿。每次调用都会消耗月度额度中的一次 AI 改写次数。

attach_reference

attach_reference

将源材料(通话记录、文章、笔记)与帖子关联。你和审核者可以阅读这些材料,但它们永远不会被发布,也不会更改帖子或重置审批状态。

参数类型描述
post_idrequirednumber帖子 ID。
textoptionalstring材料正文,最多 200,000 个字符。提供 text 或 url,不能同时提供。
urloptionalstring链接。系统会在后台获取页面,即使获取失败,也会保留该链接。
titleoptionalstring标签。如果未提供,则取自 text 的第一行。

切勿将源材料放入 content。 content 中的任何内容都会被发布。每条帖子最多可关联 20 份参考材料。

suggest_hashtags

suggest_hashtags

为草稿推荐主题标签和另一条开场白。不保存任何内容。

参数类型描述
idoptionalnumber帖子 ID。默认为你最近修改的草稿。

查找帖子

list_drafts

list_drafts

按状态列出你的帖子,并显示 ID、预览、平台和安排时间。

参数类型描述
statusoptionalstringdraft(默认值)、scheduled、posted 或 failed。
editorial_statusoptionalstring按内容看板阶段筛选。可用值与 update_draft 中的 stage 相同。
limitoptionalnumber返回数量(默认 20,最多 100)。

get_post

get_post

查看单条帖子的所有信息,包括其在各平台上的状态和参考材料(标题、链接、类型、长度和状态,但不包括材料正文)。

参数类型描述
idrequirednumber帖子 ID。

search_posts

search_posts

根据帖子内容查找已发布的帖子,例如“我那条关于定价的帖子”。搜索工作区各频道中的所有帖子,包括从 LinkedIn 导入的历史记录。

参数类型描述
queryrequiredstring最多 5 个词。每个词都必须出现在帖子中。
authoroptionalstring帖子的发布者:me,或队友的姓名,例如 Alex。省略此项则搜索整个工作区。
platformoptionalstringtwitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。
start_dateoptionalstring (YYYY-MM-DD)仅查找此日期当天或之后的帖子。
end_dateoptionalstring (YYYY-MM-DD)仅查找此日期当天或之前的帖子。
limitoptionalnumber返回的匹配数量(默认 10,最多 25)。

list_recent_posts

参数类型描述
limitoptionalnumber返回数量(默认 5,最多 10)。

list_scheduled_posts

参数类型描述
windowoptionalstringtoday、week 或 upcoming(默认值)。

delete_post

delete_post

按 ID 永久删除草稿。此操作无法撤销。无法删除已发布的帖子;没有用于删除已发布帖子的工具。

参数类型描述
idrequirednumber帖子 ID。

安排和发布

schedule_post

schedule_post

为一个或多个平台安排帖子在指定日期和时间发布。

参数类型描述
idrequirednumber帖子 ID。
scheduled_atrequiredstring (ISO 8601)发布时间,例如 2026-03-10T09:00:00Z。必须是未来时间。
platformsoptionalarray of strings默认为帖子中已有的平台。
platform_account_idsoptionalobject各平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。只有当某个平台有多个账号时才需要指定;否则会使用第一个账号。
variance_minutesoptionalnumber覆盖账号的发布时间偏差,范围为 0 到 60。发布时间会在该数值的一半范围内偏移,避免所有帖子都在同一分钟发布。0 会保持精确时间。

queue_post

queue_post

将帖子放入发布队列中的下一个空闲时段。

参数类型描述
idrequirednumber帖子 ID。
platformsoptionalarray of strings默认为帖子中已有的平台。
platform_account_idsoptionalobject各平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。只有当某个平台有多个账号时才需要指定;否则会使用第一个账号。
variance_minutesoptionalnumber覆盖账号的发布时间偏差,范围为 0 到 60。发布时间会在该数值的一半范围内偏移,避免所有帖子都在同一分钟发布。0 会保持精确时间。

返回各平台获得的发布时间。使用 get_queue_slots 可先查看时间,而不将帖子加入队列。

get_queue_slots

get_queue_slots

查看各平台下一个空闲的队列时段,不安排任何内容。

参数类型描述
platformsrequiredarray of strings要检查的平台,例如 ["linkedin", "twitter"]。

cancel_post

cancel_post

取消已安排帖子的发布。帖子会返回草稿状态;不会删除任何内容。

参数类型描述
idrequirednumber帖子 ID。

publish_post

publish_post

立即发布草稿。通过 MCP,此操作不会直接发布:它会返回一个链接,供你查看帖子并点击 Publish。

参数类型描述
idrequirednumber帖子 ID。
platformsoptionalarray of strings默认为草稿中已有的平台。
platform_account_idsoptionalobject每个平台使用哪个已连接账号发布,例如 { "linkedin": 42 }。使用 list_connected_accounts 中的 ID。仅当某个平台有多个账号时才需要;否则使用第一个账号。

pause_queue

无需参数。

resume_queue

resume_queue

重新开启发布,让已安排的帖子再次发布。

无需参数。

list_queue_schedule

list_queue_schedule

显示每个渠道每周的发布时间:每个时间、发布日、渠道 ID、是否可以更改以及时区。

参数类型描述
platformoptionalstring仅显示一个平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。

调用 add_queue_times 或 remove_queue_times 前,请先调用此工具以获取时区和渠道 ID。

add_queue_times

add_queue_times

为一个渠道的每周计划添加发布时间,例如“为 LinkedIn 添加工作日上午 9 点”。已存在的时间保持不变。队列中已有帖子的发布时间保持不变。

参数类型描述
platformrequiredstring渠道的平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。
timesrequiredarray of strings24 小时制时间,例如 ["09:00", "14:30"],使用工作区的发布时间时区。
daysrequiredarray of strings星期名称(monday 至 sunday),或 everyday、weekdays 或 weekends。
platform_account_idsoptionalobject平台有多个渠道时,指定要使用的渠道,例如 { "linkedin": 42 }。ID 来自 list_queue_schedule。

remove_queue_times

remove_queue_times

从一个渠道的每周计划中移除发布时间。队列中已有帖子的发布时间保持不变。

参数类型描述
platformrequiredstring渠道的平台:linkedin、twitter、threads、bluesky、substack、youtube、facebook 或 instagram。
timesrequiredarray of strings要移除的 24 小时制时间,例如 ["09:00"]。
daysoptionalarray of strings仅在这些日期移除。不填写则从每天移除该时间。
platform_account_idsoptionalobject平台有多个渠道时,指定要使用的渠道。ID 来自 list_queue_schedule。

图片

upload_image

upload_image

获取图片、视频或 PDF 的上传链接。返回一个 curl 命令供你运行,以及一个 s3_key,用于在 draft_post、save_draft 或 update_draft 上传入 images。

参数类型描述
filenamerequiredstring文件名,例如 photo.jpg。
content_typeoptionalstring文件类型。若未填写,则根据文件名推断。支持图片(JPEG、PNG、GIF、WebP)、视频(MP4、MOV、AVI、WebM、MKV)和 PDF,最大 100 MB。

运行 curl 命令需要能够运行命令的应用,例如 Claude Code。在聊天应用中,请改为将图片附加到 DemandBird。

generate_image

generate_image

使用 AI 生成原创图片,为帖子配图。系统会自动应用你的品牌风格。耗时 10 到 30 秒,使用一个月度图片额度,并将图片保存到媒体库。

参数类型描述
promptrequiredstring描述图片应展示的内容。描述画面,而不是帖子。
styleoptionalstringphoto、illustration(默认)、infographic 或 diagram。
sizeoptionalstringsquare(1:1,默认)、portrait(2:3)或 landscape(3:2)。

返回一个 s3_key,用于传入 images。请参阅 AI images。

审核与审批

request_review

request_review

将草稿发送给团队成员审批。必需审核人会阻止发布,直到每个人都批准;可选审核人仅供知悉。

参数类型描述
post_idrequiredstring草稿 ID。
reviewersrequiredarray of objects每位审核人都需要提供一个 email、一个 user_id 或一个 name(“Alex”)。无法识别或含义不明确的姓名会被拒绝,不会猜测。将 required: false 设为可选审核人。
noteoptionalstring给审核人的消息。
scheduled_atoptionalstring (ISO 8601)立即安排发布时间。如果所有必需审核人都已批准,则会在此时间发布。

list_posts_awaiting_my_review

参数类型描述
limitoptionalnumber数量(1 到 100,默认 20)。

approve_post

approve_post

批准你受邀审核的帖子。返回一个链接,供你阅读帖子并亲自点击 Approve。

参数类型描述
post_idrequiredstring帖子 ID。
noteoptionalstring随批准一同保存的备注。

send_back_post

send_back_post

将帖子退回给作者,并说明需要修改的内容。返回一个链接,供你亲自点击 Send back。

参数类型描述
post_idrequiredstring帖子 ID。
noterequiredstring用你自己的话说明需要修改的内容。作者会看到原文。

comment_on_post

comment_on_post

在帖子上发表评论,但不批准或退回帖子。

参数类型描述
post_idrequiredstring帖子 ID。
commentrequiredstring用你自己的话写下评论。

创意

save_idea

save_idea

将一个或多个创意保存到 Ideas 标签页。不使用 AI。一次调用中的所有创意会一起保存,否则一个也不会保存。

参数类型描述
ideasrequiredarray of objects最多 100 个。每个创意包含 content(最多 5,000 个字符),以及可选的 tags 和 references(来源材料,不会并入创意文本)。
authoroptionalstring这些创意属于谁:团队成员姓名,或 me。

list_ideas

参数类型描述
authoroptionalstring团队成员姓名,或 me。不填写则列出你的创意。
limitoptionalnumber数量(默认 20,最多 100)。

delete_idea

delete_idea

按 ID 删除创意。如果有任何 ID 无法删除,则一个也不会删除。此操作无法撤销。

参数类型描述
idsrequiredarray of numbers创意 ID,最多 100 个。

品牌与语气

get_brand_voice

get_brand_voice

读取工作区的品牌信息(定位、受众、内容支柱)和你的写作语气(表达方式、常用短语、避免使用的内容、近期编辑)。

参数类型描述
platformoptionalstring同时返回此平台近期修改前后的内容。

draft_post 和 revise_draft 已自动应用你的语气。此工具适用于 Claude 自行撰写内容,并使用 save_draft 或 update_draft 保存内容的情况。

update_voice

update_voice

更改你自己的写作语气,与 Settings → Voice 中的设置相同。例如:“我从不使用‘协同效应’这个词。”

参数类型描述
editsrequiredarray of objects每个字段一项,格式为 { field, value } 或 { field, reset: true }。每项编辑都会替换整个字段,因此请发送你希望保留的完整列表。

update_brand

update_brand

更改当前工作区的定位和受众,与 Settings 中的 Brand identity 卡片相同。

参数类型描述
positioningoptionalstring业务的内容和立场。最多 2,000 个字符。
icpoptionalstring帖子的目标受众。最多 2,000 个字符。

分析

这些工具仅用于读取。数据与 Analytics tab 中的数字一致。不包含 Reddit。

get_analytics_summary

get_analytics_summary

粉丝数、互动量、触达量和互动率,并分别显示与上一时段相比的变化。不填写 platform 则一次返回所有网络的数据。

参数类型描述
platformoptionalstringtwitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。
periodoptionalstring7d、30d 或 90d,截至今天。默认值为 30d。
start_dateoptionalstring (YYYY-MM-DD)自定义日期范围的第一天,使用你的时区。覆盖 period。最多 366 天。
end_dateoptionalstring (YYYY-MM-DD)自定义日期范围的最后一天,包含当天。默认为今天。需要提供 start_date。

list_top_posts

list_top_posts

在所有网络或单个网络中,按表现从高到低或从低到高排列帖子。返回每个帖子的 ID、统计数据、摘要和链接。

参数类型描述
authoroptionalstring帖子作者:me,或团队成员姓名,例如 Alex。不填写则涵盖整个工作区。
platformoptionalstringtwitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。
metricoptionalstring排序依据。默认值为 engagement_rate。还可以使用 engagements、reach、impressions、likes、comments、shares、discussion_rate,以及平台专属指标,例如 LinkedIn 的 profile_views、saves、sends 和 follows。如果平台不提供某项指标,则会拒绝请求并列出该平台支持的指标。
orderoptionalstringtop(默认)或 bottom。
limitoptionalnumber数量(默认 5,最多 20)。
periodoptionalstring7d、30d 或 90d,截至今天。默认值为 30d。
start_dateoptionalstring (YYYY-MM-DD)自定义日期范围的第一天,使用你的时区。覆盖 period。最多 366 天。
end_dateoptionalstring (YYYY-MM-DD)自定义日期范围的最后一天,包含当天。默认为今天。需要提供 start_date。

get_post_analytics

get_post_analytics

查看单个帖子的所有指标,包括平台提供的触达量随时间变化情况。

参数类型描述
post_idoptionalnumber已发布帖子的 ID,来自 list_top_posts。
composition_idoptionalnumberDemandBird 帖子 ID(“Draft #123”中的数字)。
latestoptionalboolean设置为 true 可获取最新帖子。添加 platform 可指定网络。
platformoptionalstringtwitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin 之一。

list_posts_with_metrics

list_posts_with_metrics 日期范围内每篇已发布帖子的所有数据,按页返回。适用于完整历史记录或导出。

参数类型描述
authoroptionalstring帖子作者:me,或队友的姓名,例如 Alex。留空则表示整个工作区。
platformoptionalstring可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。
limitoptionalnumber每页帖子数(默认 50,最多 100)。
cursoroptionalstring使用上一页末尾的游标获取下一页。
periodoptionalstring7d、30d 或 90d,截至今天。默认值为 30d。
start_dateoptionalstring (YYYY-MM-DD)范围的第一天,按你的时区计算。优先于 period。时长不限。
end_dateoptionalstring (YYYY-MM-DD)自定义范围的最后一天,包含在内。默认为今天。需要 start_date。

get_best_time_to_post

get_best_time_to_post

你的帖子在某个平台上表现最佳的日期和时段(按你的时区计算)。

参数类型描述
platformrequiredstring可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。
limitoptionalnumber时段数量(默认 3,最多 10)。
periodoptionalstring7d、30d 或 90d,截至今天。默认值为 30d。
start_dateoptionalstring (YYYY-MM-DD)自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。
end_dateoptionalstring (YYYY-MM-DD)自定义范围的最后一天,包含在内。默认为今天。需要 start_date。

get_format_performance

get_format_performance

按互动量对某个平台上的帖子格式(文本、图片、视频等)进行排名。

参数类型描述
platformrequiredstring可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。
periodoptionalstring7d、30d 或 90d,截至今天。默认值为 30d。
start_dateoptionalstring (YYYY-MM-DD)自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。
end_dateoptionalstring (YYYY-MM-DD)自定义范围的最后一天,包含在内。默认为今天。需要 start_date。

get_audience_demographics

get_audience_demographics

了解你的关注者。Instagram 和 Threads 会报告国家/地区、年龄、性别和城市。LinkedIn 公司主页会报告资历、职能、行业、公司规模和所在地。其他平台以及 LinkedIn 个人资料不会分享这些信息。

参数类型描述
platformrequiredstring可选值:twitter、bluesky、threads、facebook、instagram、mastodon、youtube、tiktok、pinterest 或 linkedin。
periodoptionalstring7d、30d 或 90d,截至今天。默认值为 30d。
start_dateoptionalstring (YYYY-MM-DD)自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。
end_dateoptionalstring (YYYY-MM-DD)自定义范围的最后一天,包含在内。默认为今天。需要 start_date。

get_follower_history

get_follower_history

按天显示个人资料或公司主页的 LinkedIn 关注者数量。数据与关注者增长图表相同。

参数类型描述
accountoptionalstring按名称或 ID 指定 LinkedIn 个人资料或主页。留空则表示全部。
periodoptionalstring7d、30d 或 90d,截至今天。默认值为 30d。
start_dateoptionalstring (YYYY-MM-DD)自定义范围的第一天,按你的时区计算。优先于 period。最多 366 天。
end_dateoptionalstring (YYYY-MM-DD)自定义范围的最后一天,包含在内。默认为今天。需要 start_date。

tag_published_post

tag_published_post

为已发布的帖子设置标签,包括在 DemandBird 之外发布的帖子。

参数类型描述
post_idrequirednumber已发布帖子的 ID,可从 list_top_posts 或 search_posts 获取。
tagsrequiredarray of strings替换帖子的标签;[] 会移除所有标签。

团队

仅限账户管理员。

list_members

list_members

账户中的所有成员、待处理邀请以及剩余席位数。

无需参数。

invite_member

invite_member

邀请人员加入账户。返回一个链接,你可以在其中检查每个人及其角色,然后自行点击“发送”。

参数类型描述
invitesrequiredarray of objects每项包含 name、email 和 role(admin、member、read_only、ghostwriter 或 client),以及可选的 workspace_roles。