Audiense MCP 服务器的 TweetBinder

这是Audiense API 的 TweetBinder的模型上下文协议 (MCP)服务器，允许Claude和其他与 MCP 兼容的 AI 模型访问 Audiense 的 TweetBinder 分析数据。

特征

直接从 Claude 访问 TweetBinder 分析
分析 Twitter/X 上的主题标签、用户和对话
获取参与度指标、情绪分析等
使用自定义搜索查询创建 Twitter 报告
检查报告生成状态
检索详细报告统计信息
获取账户余额及额度信息
统计符合特定查询的推文数量
列出并管理您的 TweetBinder 报告
从报告中访问推文内容和用户信息

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 mcp-tweetbinder：

npx -y @smithery/cli install @AudienseCo/mcp-tweetbinder --client claude

手动配置

先决条件

Node.js （v18 或更高版本）
克劳德桌面应用程序
具有 API 凭证的Audiense 帐户的 TweetBinder

克隆此存储库
安装依赖项：
npm install
构建项目：
npm run build

您需要一个有效的 TweetBinder API Bearer Token 才能使用此服务。请在您的环境中进行设置：

export TWEETBINDER_API_TOKEN='your-bearer-token-here'

与 Claude Desktop 一起使用

编辑您的 Claude Desktop 配置文件：
- MacOS：
  code ~/Library/Application\ Support/Claude/claude_desktop_config.json
- 视窗：
  code %AppData%\Claude\claude_desktop_config.json
添加此配置：

"mcpServers": {
  "tweetbinder": {
    "command": "node",
    "args": [
      "/absolute/path/to/build/index.js"
    ],
    "env": {
      "TWEETBINDER_API_TOKEN": "your-bearer-token-here"
    }
  }
}

重启Claude桌面

可用工具

`create-twitter-report`

创建一份新报告，根据搜索查询分析 Twitter/X 数据。

参数：
- query （字符串）：Twitter 数据的搜索查询。可以包含 AND、OR、主题标签、提及等运算符。
- limit （数字，可选）：要检索的推文的最大数量（最多 50,000 条）。
- startDate （数字，可选）：开始日期为 Unix 时间戳（自纪元以来的秒数）。
- endDate （数字，可选）：结束日期为 Unix 时间戳（自纪元以来的秒数）。
- reportType （枚举，可选）：要创建的报告类型：“7 天”表示上周报告，“历史”表示所有时间报告。默认值：“7 天”。
回复：
- 已创建报告的报告 ID 和状态信息。
- 检查报告状态和检索统计数据的说明。

`create-twitter-count`

创建一份新报告，统计与搜索查询匹配的推文数量。

参数：
- query （字符串）：Twitter 数据的搜索查询。可以包含 AND、OR、主题标签、提及等运算符。
- reportType （枚举，可选）：要创建的报告类型：“7 天”表示上周报告，“历史”表示所有时间报告。默认值：“7 天”。
回复：
- 原始 JSON 响应包含：
  - status ：报告创建的状态
  - resourceId ：所创建报告的 ID
  - error / message ：任何错误或状态消息

`list-reports`

检索所有 TweetBinder 报告的列表，并具有排序功能。

参数：
- order （字符串，可选）：排序参数，格式为“field|direction”。例如：“createdAt|-1”表示最新记录优先，“createdAt|1”表示最旧记录优先。
回复：
- 原始 JSON 响应包含一系列报告，每个报告都有详细信息：
  - id ：报告 ID
  - name ：报告名称
  - status ：当前状态（已生成、等待等）
  - createdAt ：创建时间戳
  - updatedAt ：上次更新时间戳
  - type ：报告类型
  - source ：报告来源
  - query ：原始搜索查询

`get-report-content`

使用高级过滤和分页功能从生成的报告中检索实际的推文或用户。

参数：
- reportId （字符串）：要检索内容的报告的 ID。
- contentType （枚举）：要检索的内容类型：推文数据为“tweets”，用户数据为“users”。
- page （数字，可选）：分页的页码。从 1 开始。
- perPage （数字，可选）：每页的项目数。
- sortBy （字符串，可选）：排序字段（例如，“createdAt”，“counts.favorites”）。
- sortDirection （枚举，可选）：排序方向：'1' 表示升序，'-1' 表示降序。
- filter （字符串，可选）：包含过滤条件的 JSON 字符串。例如：'{"counts.favorites":{"$gt":10}}'
回复：
- 原始 JSON 响应包含：
  - items ：推文或用户对象的数组
  - pagination ：有关总项目和页数的信息
请求推文时，会返回详细信息，包括：
- 推文 ID、文本、创建日期、语言
- 作者详细信息（姓名、用户名、关注者等）
- 参与度指标（转发、点赞、回复等）
- 媒体内容（标签、图片、链接）
- 情绪分析
请求用户时，信息包括：
- 用户 ID、姓名、用户名
- 个人资料图片网址
- 关注者和关注者数量
- 验证状态
- 用户价值和其他指标

**注意：**报告必须处于“已生成”状态才能访问内容。请使用get-report-status工具检查报告是否已准备就绪。

查询语法示例：

#apple ：包含主题标签#apple 的推文
apple lang:en ：包含“apple”的英文推文
(#apple OR #iphone) -#android ：带有 #apple 或 #iphone 但不带有 #android 的推文
@apple ：提及@apple的推文
from:apple ：用户“apple”发布的推文

**注意：**创建计数报告后，使用get-report-status工具检查其是否准备就绪，然后使用get-report-stats获取实际计数。

`get-report-status`

检查 TweetBinder 报告的当前状态。

参数：
- reportId （字符串）：要检查的报告的 ID。
回复：
- 报告的当前状态，可以是以下之一：
  - 已生成：报告已完成并可供使用。
  - 等待：报告仍在生成或等待收集推文。
  - 已过时：该报告正在使用新数据进行更新，并将很快提供。
  - 已删除：报告已被删除，不再可用。
  - 已存档：该报告已存档，可能很快会被删除。
- 对状态的含义以及可采取的操作的解释。

**注意：**您必须首先使用create-twitter-report或create-twitter-count工具创建报告以获取报告 ID。

`get-report-stats`

检索 TweetBinder 报告的综合统计数据和分析。

参数：
- reportId （字符串）：要检索统计信息的报告的 ID。
回复：
- 报告统计数据的格式化摘要，包括：
  - 概述：推文总数、日期范围、贡献者、参与度、媒体和链接。
  - 参与度指标：潜在影响力、印象、转发和点赞。
  - 情绪分析：整体情绪得分和解释。
  - 顶级贡献者：最活跃的用户及其推文数量。
  - 热门内容：转发次数最多的帖子。
  - 常用标签：对话中常用的标签。

**注意：**报告必须处于“已生成”状态，才能检索统计信息。请使用get-report-status工具检查报告是否已准备就绪。

`get-account-balances`

检索有关您帐户的信用余额、使用情况和剩余配额的信息。

参数：
- 没有任何
返回：
- 原始 JSON 响应包含：
  - total ：可用学分总数
  - used ：已使用的积分
  - available ：当前可用积分
  - discount ：任何适用的折扣
  - remainingReports ：剩余报告数量
  - quota ：配额信息包括：
    - startedAt ：配额期开始日期
    - finishedAt ：配额期限结束日期
    - remaining ：剩余配额
    - used ：已使用配额
    - total ：总配额
- 任何错误或状态消息

故障排除

Claude 中未出现的工具

检查 Claude Desktop 日志：

tail -f ~/Library/Logs/Claude/mcp*.log

验证环境变量是否设置正确。
确保index.js的绝对路径正确。

身份验证问题

再次检查凭证。
确保刷新令牌仍然有效。
验证所需的 API 范围是否已启用并且您是否有足够的积分。

查看日志

要检查服务器日志：

对于 MacOS/Linux：

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

对于 Windows：

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

安全注意事项

确保 API 凭证的安全 - 切勿在公共存储库中暴露它们。
使用环境变量来管理敏感数据。

📄 许可证

本项目遵循 Apache 2.0 许可证。更多详情请参阅许可证文件。

TweetBinder by Audiense MCP Server