简介

允许克劳德和其他与MCP兼容的AI模型访问Audiense的TweetBinder分析数据，从而可以通过参与度指标、情感分析和报告生成来分析Twitter/X上的标签、用户和对话。

简介

允许克劳德和其他与MCP兼容的AI模型访问Audiense的TweetBinder分析数据，从而可以通过参与度指标、情感分析和报告生成来分析Twitter/X上的标签、用户和对话。

TweetBinder by Audiense MCP 服务器

这是一个 模型上下文协议 (MCP) 服务器，用于 Audiense 的 TweetBinder API，允许 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 或更高版本）
• Claude Desktop 应用程序
• Audiense 的 TweetBinder 账户及 API 凭证

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

您需要一个有效的 TweetBinder API Bearer Token 来使用此服务。在环境变量中设置它：

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

与 Claude Desktop 一起使用

1. 编辑您的 Claude Desktop 配置文件：

   • MacOS:

     code ~/Library/Application\ Support/Claude/claude_desktop_config.json
     

   • Windows:

     code %AppData%\Claude\claude_desktop_config.json
     

2. 添加以下配置：

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

3. 重启 Claude Desktop

可用工具

create-twitter-report

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

• 参数:

  • query (字符串): Twitter 数据的搜索查询。可以包含 AND、OR 等操作符、主题标签、提及等。
  • limit (数字, 可选): 要检索的最大推文数量（最多 50,000 条）。
  • startDate (数字, 可选): 开始日期作为 Unix 时间戳（自纪元以来的秒数）。
  • endDate (数字, 可选): 结束日期作为 Unix 时间戳（自纪元以来的秒数）。
  • reportType (枚举, 可选): 要创建的报告类型："7-day" 表示上周或 "historical" 表示所有时间。默认值："7-day"。

• 响应:

  • 创建报告的报告 ID 和状态信息。
  • 检查报告状态和检索统计信息的说明。

create-twitter-count

创建一个新的报告，统计符合搜索查询的推文数量。

• 参数:

  • query (字符串): Twitter 数据的搜索查询。可以包含 AND、OR、话题标签、提及等操作符。
  • reportType (枚举, 可选): 要创建的报告类型："7-day" 表示上周，"historical" 表示所有时间。默认值: "7-day"。

• 响应:

  • 原始 JSON 响应，包含：
    • status: 报告创建的状态
    • resourceId: 创建的报告 ID
    • error/message: 任何错误或状态消息

list-reports

检索带有排序功能的所有 TweetBinder 报告列表。

• 参数:

  • order (字符串, 可选): 排序参数，格式为 '字段|方向'。例如：'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、姓名、用户名
  • 头像 URL
  • 关注者和被关注者数量
  • 验证状态
  • 用户价值及其他指标

注意: 报告必须处于“已生成”状态才能访问其内容。使用 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。

• 响应：

  • 报告的当前状态，可以是以下之一：
    • Generated：报告已完成并可使用。
    • Waiting：报告仍在生成中或等待收集推文。
    • Outdated：报告正在用新数据更新，很快将可用。
    • Deleted：报告已被删除，不再可用。
    • Archived：报告已存档，可能很快会被删除。
  • 状态的解释以及可用的操作。

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

get-report-stats

检索 TweetBinder 报告的全面统计信息和分析。

• 参数：

  • reportId (字符串)：要检索统计信息的报告的 ID。

• 响应：

  • 报告统计信息的格式化摘要，包括：
    • 概述：总推文数、日期范围、贡献者、参与度、媒体和链接。
    • 参与度指标：潜在覆盖范围、展示次数、转发和点赞。
    • 情感分析：总体情感得分及其解释。
    • 顶级贡献者：最活跃的用户及其推文数量。
    • 热门内容：被转发最多的帖子。
    • 常用标签：对话中常用的标签。

注意： 在检索统计信息之前，报告的状态必须为 "Generated"。使用 get-report-status 工具检查报告是否已准备好。

get-account-balances

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

• 参数：

  • 无

• 返回：

  • 包含以下内容的原始 JSON 响应：
    • total：可用的总信用
    • used：已使用的信用
    • available：当前可用的信用
    • discount：任何适用的折扣
    • remainingReports：剩余报告数量
    • quota：配额信息，包括：
      • startedAt：配额期开始日期
      • finishedAt：配额期结束日期
      • remaining：剩余配额
      • used：已使用配额
      • total：总配额
  • 任何错误或状态消息

故障排除

工具未出现在 Claude 中

1. 检查 Claude Desktop 日志：

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

2. 验证环境变量设置是否正确。
3. 确保到 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 许可证。更多详情请参阅 LICENSE 文件。

来源

• 来源：github
• 链接：https://github.com/audienseco/mcp-tweetbinder