meta-mcp 是一个覆盖 Instagram Graph API（v26.0）、Threads API 与 Meta 平台管理的 MCP 服务器。它把社交平台的常见操作封装为可供 AI 助手调用的工具，使用户可以通过自然语言指令完成发布、评论管理、数据查看等任务。
【用途】 该项目主要用于将 Instagram 和 Threads 的账号运营能力接入 AI 助手，让 AI 可以直接执行发布内容、读取分析数据、管理互动等操作。典型指令示例包括：向 Instagram 发布照片；在 Threads 发布带投票的文本帖；获取 Instagram 粉丝数与洞察；安排轮播帖；回复最新帖子的评论；跨平台同时发布到 Instagram 和 Threads；查看 Threads 账号分析；管理 Instagram 私信。
【主要能力】 项目共提供 66 个工具，分为三个平台：
- Instagram（33 个）：发布照片、视频、Reels、快拍和轮播（含替代文本），管理评论，查看洞察，搜索话题标签，管理私信，处理合作邀请。
- Threads（27 个）：发布文本、图片、视频和轮播，支持投票、GIF、话题标签、链接附件、替代文本、剧透标记、Ghost Posts（24 小时后自动归档）、回复审批、位置标记，以及交叉分享到 Instagram Stories；管理回复与待审批回复；搜索帖子与位置；个人资料与提及发现；oEmbed；查看洞察；删除帖子。
- Meta 平台（6 个）：Token 交换、刷新、调试，以及 Webhook 管理。 此外还包含 2 个资源（Instagram 个人资料、Threads 个人资料）和 2 个提示（跨平台内容发布、分析报告），并通过 x-app-usage 响应头跟踪速率限制。
【版本更新要点】
- v2.2.0：修复 Instagram 业务发现与合作邀请请求；账号洞察支持 metric_type、breakdown 与人口统计时间范围；独立视频现以分享到信息流的 Reels 形式发布；照片、Reel 和轮播发布支持 AI 信息与付费合作标签，Reels 还支持 trial_params；公开 Threads oEmbed 无需 Token 即可使用。
- v2.1.0：升级到 Graph API v26.0；移除 Tenor，仅保留 GIPHY 作为 GIF 提供方；新增 Threads Ghost Posts、回复审批、交叉分享到 Instagram Stories、位置标记、个人资料发现、提及、oEmbed、会话回复等能力；修复 threads_search_posts 使其调用正确的 /keyword_search 端点；扩展帖子/回复字段。
- v2.0.0：从 Graph API v21.0 升级到 v25.0；替换已弃用指标；新增 Threads 投票、GIF、话题标签、链接附件、帖子搜索、帖子删除、发布配额检查、引用帖、剧透标记、替代文本、新回复控制；Instagram 替代文本与合作邀请；更新洞察指标。
【使用方式】 项目提供两种运行方式，具体安装命令与启动配置在官方仓库中提供，本介绍不重复列出代码。通常需要先创建 Meta 开发者应用，再分别配置 Instagram 和 Threads 的访问令牌与环境变量。仅使用某平台时，只需设置该平台对应的变量，例如仅使用 Threads 时设置 THREADS_ACCESS_TOKEN 和 THREADS_USER_ID。
Instagram 配置要求：需要 Instagram 商业或创作者账号，在 Meta 应用中添加 Instagram Graph API 产品，通过 Facebook 主页连接 Instagram 商业账号，在 Graph API Explorer 中生成并授权所需权限（instagram_basic、instagram_content_publish、instagram_manage_comments、instagram_manage_insights、instagram_manage_contents、instagram_manage_messages、pages_show_list、pages_read_engagement、pages_manage_metadata），再将短期令牌换成约 60 天的长期令牌，并获取 INSTAGRAM_USER_ID、INSTAGRAM_PAGE_ID、INSTAGRAM_MESSAGING_ACCESS_TOKEN。
Threads 配置要求：适用于任意 Threads 账号（个人或商业），自 2025 年 9 月起不再要求关联 Instagram 账号。需要在 Meta 应用中添加 Threads API 产品，将账号添加为 Threads 测试员并在 Threads 应用接受邀请，生成授权链接并获取授权码，再换取短期令牌与约 60 天的长期令牌，最后获取 THREADS_USER_ID。
Token 管理：访问令牌约 60 天后过期，需在过期前刷新。Instagram 可使用 meta_refresh_token 并指定 platform=instagram（需 META_APP_ID 与 META_APP_SECRET）；Threads 可使用 meta_refresh_token 并指定 platform=threads，或调用 Threads 的 refresh_access_token 接口。随时可用 meta_debug_token 检查令牌状态。
【适用场景】 适合需要借助 AI 助手批量或自动化运营 Instagram 与 Threads 账号的场景，例如内容发布与排期、评论与私信互动管理、账号与帖子数据分析、跨平台内容分发，以及把社交平台能力集成进 AI Agent 工作流。项目还提供了 llms.txt 机器可读摘要和 templates/CLAUDE.md、templates/AGENTS.md 模板，便于自动发现 MCP。
【限制】 Instagram 部分需要商业或创作者账号；Threads 部分需要账号被添加为 Threads 测试员。访问令牌有约 60 天有效期，需要刷新。部分操作存在速率限制，例如 Threads 删除帖子限制为每天 100 次，项目通过 x-app-usage 头跟踪。旧的 Instagram 指标如 impressions、video_views、engagement 已在 Graph API v22.0 弃用，并于 2025 年 4 月 21 日移除，需改用 views、reach、saved、shares 等新指标。具体的定价、收费信息暂未提供。
