内容
# Minter.io MCP 服务器 - 示例
**询问您的 AI 助手关于您的社交媒体分析。** 将 **Claude**、
**ChatGPT**、**Copilot** 或 **Gemini** 连接到您的 Instagram、TikTok、X/Twitter、
Facebook、LinkedIn 和 Threads 数据与 [Minter.io](https://minter.io)
MCP 服务器 - 连接只需一分钟，无需复制 API 密钥。
> **服务器端点：** `https://minter.io/mcp`
>
> 文档：[minter.io/mcp](https://minter.io/mcp) · 设置指南：[minter.io/connect-to-ai](https://minter.io/connect-to-ai)
询问类似的问题：
> *"我的关注者增长与上个月相比如何？*"
> *"哪些帖子在本季度获得了最多的互动？*"
> *"将我的互动率与我跟踪的竞争对手进行比较。*"
更多信息请参见 [提示库](docs/prompts.md)。
## 这是什么？
[Minter.io](https://minter.io) 是一个社交媒体分析平台。其 MCP
([模型上下文协议](https://modelcontextprotocol.io)) 服务器允许任何
支持 MCP 的 AI 助手查询您在 Minter.io 上已经跟踪的报告 -
安全地，通过 OAuth 2.0 + PKCE。您的助手只看到您跟踪的报告，绝无更多。
此仓库包含：
- Claude、ChatGPT 等助手的快速入门指南
- 以编程方式调用服务器的示例脚本（Python 和 TypeScript）
- 一个现成的“每周报告”自动化工具（GitHub Actions）
- 一个 [有效的提示库](docs/prompts.md)
## 快速开始（无需代码）
### Claude
1. 打开 **设置 → 连接器 → 添加自定义连接器**
2. 粘贴 `https://minter.io/mcp`
3. 在提示时使用您的 Minter.io 账户登录
4. 询问： *"我的关注者增长与上个月相比如何？*"
### ChatGPT
Minter.io 是一个已批准的应用程序 - 从
[ChatGPT 应用程序目录](https://chatgpt.com/apps/minter-io/asdk_app_6a2d50ea97c88191b602860a847f8603)
中添加它并登录。
### 其他助手（Copilot、Gemini 等）
任何支持 MCP 连接器的助手都以相同的方式工作：添加
`https://minter.io/mcp` 作为连接器并登录。
需要一个具有 [AI 分析师](https://minter.io/ai-analyst)
功能的 Minter.io 账户 - 包含在 [14 天免费试用](https://minter.io) 中，无需信用卡。
### 平台特定设置指南
每个平台的逐步指南和截图：
| 平台 | Claude | ChatGPT |
| --- | --- | --- |
| Instagram | [指南](https://minter.io/connect-instagram-to-claude) | [指南](https://minter.io/connect-instagram-to-chatgpt) |
| Instagram 标签 | [指南](https://minter.io/connect-instagram-hashtags-to-claude) | [指南](https://minter.io/connect-instagram-hashtags-to-chatgpt) |
| Instagram 竞争对手 | [指南](https://minter.io/connect-instagram-competitors-to-claude) | [指南](https://minter.io/connect-instagram-competitors-to-chatgpt) |
| TikTok | [指南](https://minter.io/connect-tiktok-to-claude) | [指南](https://minter.io/connect-tiktok-to-chatgpt) |
| X/Twitter | [指南](https://minter.io/connect-twitter-to-claude) | [指南](https://minter.io/connect-twitter-to-chatgpt) |
| X/Twitter 标签 | [指南](https://minter.io/connect-twitter-hashtags-to-claude) | [指南](https://minter.io/connect-twitter-hashtags-to-chatgpt) |
| X/Twitter 竞争对手 | [指南](https://minter.io/connect-twitter-competitors-to-claude) | [指南](https://minter.io/connect-twitter-competitors-to-chatgpt) |
| Facebook | [指南](https://minter.io/connect-facebook-to-claude) | [指南](https://minter.io/connect-facebook-to-chatgpt) |
| Facebook 竞争对手 | [指南](https://minter.io/connect-facebook-competitors-to-claude) | [指南](https://minter.io/connect-facebook-competitors-to-chatgpt) |
| LinkedIn | [指南](https://minter.io/connect-linkedin-to-claude) | [指南](https://minter.io/connect-linkedin-to-chatgpt) |
| Threads | [指南](https://minter.io/connect-threads-to-claude) | [指南](https://minter.io/connect-threads-to-chatgpt) |
## 可用工具
| 工具 | 功能 |
| --- | --- |
| `accounts_discovery` | 列出您跟踪的账户、标签和竞争对手，以便助手知道可以分析哪些内容 |
| `field_discovery` | 显示给定报告的可用指标（关注者、互动、浏览量、帖子分析...） |
| `data_query` | 获取任何指标和日期范围的数字 |
按此顺序调用它们：`accounts_discovery` → `field_discovery` → `data_query`。
**注意事项和限制**
- 日期使用 `yyyy-mm-dd`；查询默认为最近 30 天，最多 2 年历史记录
- `data_query` 返回 CSV，每次调用最多 100 行
- 速率限制：每个连接每小时 5000 次请求
## 编程示例
两种主要的 LLM API 都支持远程 MCP 服务器，因此您可以基于 Minter.io 数据构建自己的自动化工具 -
Anthropic Messages API 通过
[MCP 连接器](https://docs.claude.com/en/docs/agents-and-tools/mcp-connector)，
OpenAI Responses API 通过
[MCP 工具](https://developers.openai.com/api/docs/guides/tools-connectors-mcp)：
| 示例 | Claude（Anthropic API） | ChatGPT（OpenAI API） |
| --- | --- | --- |
| “提问”CLI，Python | [`ask.py`](examples/python/ask.py) | [`ask_openai.py`](examples/python/ask_openai.py) |
| “提问”CLI，TypeScript | [`ask.ts`](examples/typescript/ask.ts) | [`ask_openai.ts`](examples/typescript/ask_openai.ts) |
| 每周 Markdown 报告，Python | [`weekly_report.py`](examples/python/weekly_report.py) | — |
- [`.github/workflows/weekly-report.yml`](.github/workflows/weekly-report.yml) —
按计划运行每周报告并将其提交到仓库。
**在私有仓库中运行** - 报告包含您的分析数据。
示例中硬编码了模型 ID (`claude-sonnet-5` / `gpt-5.6`) 和
Anthropic MCP beta 头部 (`mcp-client-2025-11-20`)；当更新任何这些时，
请更新每个示例。
所有示例都需要：
| 环境变量 | 功能 |
| --- | --- |
| `ANTHROPIC_API_KEY` | 您的 Anthropic API 密钥（Claude 示例） |
| `OPENAI_API_KEY` | 您的 OpenAI API 密钥（`*_openai` 示例） |
| `MINTER_OAUTH_TOKEN` | 您的 Minter.io 账户的 OAuth 访问令牌（通过标准 OAuth 2.0 + PKCE 流程获取 - 参见 [身份验证](#身份验证)） |
## 身份验证
服务器使用带有 PKCE（S256）的 OAuth 2.0 并支持动态客户端注册，
因此交互式 MCP 客户端（Claude、ChatGPT、MCP Inspector）
自动连接 - 无需 API 密钥。
对于无头/脚本化使用，您完成一次 OAuth 流程并将
生成的访问令牌作为承载令牌传递:
- 授权端点：`https://minter.io/oauth/authorize`
- 受保护的资源元数据：`https://minter.io/.well-known/oauth-protected-resource`
- 服务器元数据：`https://minter.io/.well-known/oauth-authorization-server`
获取本地实验令牌的最简单方法是
[MCP Inspector](https://github.com/modelcontextprotocol/inspector):
```bash
npx @modelcontextprotocol/inspector
# 连接到 https://minter.io/mcp（Streamable HTTP），完成 OAuth 流程，
# 然后从身份验证设置中复制访问令牌
```
> **注意：** 访问令牌有效期为一年。当令牌过期时，
> 长时间运行的自动化工具（例如计划的每周报告）将开始
> 出现身份验证错误 - 再次完成 OAuth 流程并
> 更新存储的密钥。
## 支持的平台
Instagram（账户、标签、竞争对手）· X/Twitter（账户、标签、
竞争对手）· TikTok · Facebook（页面、竞争对手）· LinkedIn（页面）·
Threads
## 链接
- [Minter.io MCP 服务器](https://minter.io/mcp)
- [连接到 AI - 每个平台的设置指南](https://minter.io/connect-to-ai)
- [AI 分析师](https://minter.io/ai-analyst)
- [模型上下文协议](https://modelcontextprotocol.io)
## 许可证
此仓库中的示例采用 MIT 许可证。Minter.io 本身是一项商业
服务 - 参见 [minter.io/terms](https://minter.io/terms)。
