摘要
从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。
引导式设置
2 分钟将 Threads 连接到 Gemini
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Threads,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Threads 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → Threads,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需
git clone,无需本地服务器。
Threads + Gemini
从你的 AI 运行一个 Threads 个人资料:阅读帖子、回复、整个对话和提及,发布和账户洞察,关键词搜索和公共资料,发布文本、图像、视频和轮播帖子及回复,并隐藏或批准回复。一个长期有效的 Threads 用户令牌。
前提条件
请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:
THREADS_ACCESS_TOKEN
第一步 — 获取凭据
设置大约需要 15 分钟。你需要一个具有 访问 Threads API 用例的 Meta 应用,以及一个用于连接器应作为其操作的个人资料的长期有效的 Threads 用户令牌。它适用于任何授权了你的应用的 Threads 个人资料,包括个人账户。
- 在 developers.facebook.com/apps/creation 创建一个 Meta 应用,使用案例为 访问 Threads API。在用例的 自定义 页面上添加所需的权限:
threads_basic(始终)、threads_content_publish、threads_read_replies、threads_manage_replies和threads_manage_insights,如果你使用这些工具,还需添加threads_manage_mentions、threads_keyword_search、threads_profile_discovery、threads_location_tagging和threads_delete。 - 当应用处于开发状态时,只有其自身人员可以授权。将个人资料添加到 应用角色 → 角色 → 添加人员 → Threads 测试者,然后在 Threads 中接受邀请(设置 → 账户 → 网站权限 → 邀请)。
- 获取用户令牌:在 Graph API Explorer 中选择你的应用,将主机切换到
threads.net,选择权限并点击 生成 Threads 访问令牌。此令牌有效期为一个小时。 - 通过打开
https://graph.threads.net/access_token?grant_type=th_exchange_token&client_secret=<Threads app secret>&access_token=<short-lived token>交换为长期有效的令牌(60 天)。Threads 应用密钥在 应用设置 → 基本 下。复制答案中的access_token。 - 将其粘贴到
THREADS_ACCESS_TOKEN中,不要带上 Bearer(它以TH开头)。安装连接器并运行threads_get_profile检查连接:它返回个人资料的用户 ID 和用户名。
令牌有效期为 60 天:Threads 不为此类连接器提供刷新令牌,因此你粘贴的令牌是唯一的凭据。在 60 天到期之前(并且至少在发出后 24 小时)刷新它,方法是打开 https://graph.threads.net/refresh_access_token?grant_type=th_refresh_token&access_token=<current token>,然后将新令牌粘贴到连接器中。未及时刷新令牌无法续期:重复步骤 3 和 4。访问令牌调试器 显示令牌何时过期。
云和自托管的工作方式相同:你在 Meta 创建令牌并粘贴进去。无需在 AnythingMCP 中设置重定向 URL。
从哪里开始:threads_get_profile,然后 threads_list_posts 获取个人资料的帖子。对连接的个人资料执行操作的工具使用 me,因此你无需传递用户 ID。对于回复,threads_list_replies 返回对帖子的顶级回复,threads_get_conversation 返回其下的所有内容,使用 replied_to 重建树。threads_list_mentions 和 threads_list_my_replies 覆盖个人资料的其余活动。
洞察:threads_get_post_insights 返回一个帖子的浏览量、点赞数、回复数、转发数、引用和分享;threads_get_account_insights 返回个人资料在一段时间内的总览、每日浏览量以及从 100 个关注者中获取的关注者人口统计信息。洞察仅存在于连接的个人资料的帖子中。
发现:threads_search_posts 按关键词或主题标签搜索(没有获得批准的 threads_keyword_search 权限时,它仅搜索个人资料自己的帖子;每 24 小时 2,200 次搜索)。threads_lookup_profile 和 threads_list_profile_posts 通过精确用户名读取公共资料,threads_search_locations 查找要标记的位置 ID。
发布是公开的:AI 显示确切的文本和媒体,并在发布之前等待确认。文本帖子或回复是一个调用,threads_post_text(最多 500 个字符;reply_to_id 使其成为回复)。图像或视频帖子需要 threads_create_container 和公共媒体 URL,对于视频,使用 threads_get_container_status 直到其状态为 FINISHED(平均约 30 秒),然后 threads_publish。轮播是 2 到 20 个项目容器,一个 CAROUSEL 容器包含它们的 ID 和文本,然后 threads_publish。threads_repost 重新发布帖子。threads_get_publishing_limit 显示配额:每 24 小时 250 个帖子、1,000 个回复和 100 个删除。
审核:threads_hide_reply 隐藏或取消隐藏个人资料帖子上的顶级回复。对于使用回复批准创建的帖子,threads_list_pending_replies 和 threads_manage_pending_reply 批准或忽略被保留的回复。
安装时关闭:threads_delete_post(永久删除帖子、回复或转发)。删除无法撤销,并且需要 threads_delete 权限。仅当 AI 应该删除时,在连接器页面上打开它;它会要求你确认每个调用。发布、转发、隐藏回复和批准回复是开启的(threads_post_text、threads_create_container、threads_publish、threads_repost、threads_hide_reply、threads_manage_pending_reply)。
分页和 ID:列表返回 data 和 paging.cursors;AI 将 paging.cursors.after 作为 after 传递,直到它缺失,每页最多 100 项。ID 是数字字符串,保持不变。since 和 until 采用 Unix 秒或日期。
常见错误:190 表示令牌过期或被撤销(用户移除了应用或更改了密码),或者它是 Facebook 或 Instagram 令牌而不是 Threads 令牌:创建一个新令牌(步骤 3 和 4)。10 或 200 表示缺少权限:在用例中添加并重新生成令牌。4、17、32 或 613 是速率限制:等待几分钟。ERROR 状态的容器通常意味着 Meta 无法下载媒体 URL(必须是公共的且不能重定向)或格式不受支持。
未涵盖:除了拥有令牌的个人资料之外的其他 Threads 个人资料(为第二个个人资料添加第二个连接器),以及 Facebook 和 Instagram API。
第二步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第三步 — 在 Gemini 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list)—anythingmcp应显示为已连接。 - 开始输入提示 — Gemini CLI 现在可以调用
Threads的工具。
可用工具
| 工具 | 功能 |
|---|---|
threads_get_profile | 连接的 Threads 个人资料:id、用户名、显示名称、个人简介、个人资料图片 URL 和 is_verified |
threads_get_publishing_limit | 个人资料已使用的滚动 24 小时配额:帖子(配额使用 250,轮播计一次)、回复(reply_quota_usage… |
threads_list_posts | 列出连接的个人资料发布的帖子,最新的在前:id、文本、媒体类型和 URL、永久链接、时间戳、引用和转发链接… |
threads_get_post | 通过媒体 ID 获取一个 Threads 帖子或回复:文本、媒体类型和 URL、永久链接、所有者、时间戳、轮播的子项、引用或转发… |
threads_list_my_replies | 列出连接的个人资料在任何帖子上写的回复,最新的在前,并附上每个回复所回答的帖子(replied_to、root_post) |
threads_list_mentions | 列出其他个人资料提及连接的个人资料的公共帖子(@username),最新的在前 |
threads_list_replies | 列出对帖子的顶级回复(不是对回复的回复),默认最新的在前,包含用户名、文本、时间戳、hide_status 和… |
threads_get_conversation | 帖子下的整个对话作为一个扁平列表:顶级和嵌套回复,每个回复都有 replied_to 和 root_post,以便重建树。 |
threads_list_pending_replies | 列出在启用了回复批准的帖子上等待批准的回复(enable_reply_approvals)。… |
threads_hide_reply | 隐藏或取消隐藏连接的个人资料帖子上的顶级回复 |
threads_manage_pending_reply | 批准或忽略待处理回复(来自 threads_list_pending_replies) |
threads_get_post_insights | 连接的个人资料某个帖子的生命周期参与度:浏览量、点赞数、回复数、转发数、引用和分享 |
threads_get_account_insights | 连接账户在一段时间内的个人资料级洞察:浏览量(每日)、点赞数、回复数、转发数、引用、链接点击和… |
threads_search_posts | 按关键词或主题标签搜索公共 Threads 帖子,最受欢迎(TOP)或最新(RECENT),可选择仅文本、图像或视频帖子… |
threads_lookup_profile | 通过精确用户名获取另一个 Threads 用户的公共资料:姓名、个人简介、个人资料图片、is_verified、关注者数量和点赞数… |
threads_list_profile_posts | 通过精确用户名列出另一个 Threads 个人资料的最近公共帖子,最新的在前 |
threads_search_locations | 按名称或坐标查找要在帖子中标记的地点;返回带有名称、地址、城市、国家和坐标的位置 ID |
threads_post_text | 发布文本帖子或文本回复,一步完成(auto_publish_text):它立即在连接的个人资料上生效 |
threads_create_container | 发布图像、视频或轮播帖子(或回复)的第一步:从公共 URL 创建媒体容器 |
threads_get_container_status | 发布前媒体容器的状态:IN_PROGRESS(仍在处理,请在几秒钟后再检查)、FINISHED(准备好… |
threads_publish | 发布的第二步:在连接的个人资料上发布 FINISHED 媒体容器 |
threads_repost | 在连接的个人资料上重新发布已发布的 Threads 帖子(类似于转发按钮) |
threads_delete_post | 永久删除连接的个人资料的帖子、回复或转发 |
示例提示
- "我过去 30 天内的哪些 Threads 帖子获得了最多的浏览量,每个帖子获得了多少回复?"
- "展示我最新帖子的整个对话,并总结人们在问什么。"
- "草拟一个对该帖子下方顶级问题的回复,并在发布之前展示给我。"
- "我个人资料的浏览量和关注者在这个月如何变化?"
- "查找最近关于我们产品名称的 Threads 帖子,并列出撰写它们的账户。"
常见问题
令牌过期后会发生什么? 调用失败,错误为 190。在 60 天到期之前使用 grant_type=th_refresh_token 刷新令牌,并将新令牌粘贴到连接器中;过期后,生成新令牌并再次交换。
它可以删除帖子吗? 只有在你在连接器页面上开启 threads_delete_post 并且令牌具有 threads_delete 权限时才能删除。安装时默认关闭。
Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?