TweetBinder by Audiense MCP Server

Audiense MCP 服务器的 TweetBinder

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

特征

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

安装

通过 Smithery 安装

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

手动配置

先决条件

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

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

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

与 Claude Desktop 一起使用

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

3. 重启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 中未出现的工具

1. 检查 Claude Desktop 日志：

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

身份验证问题

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

查看日志

要检查服务器日志：

对于 MacOS/Linux：

对于 Windows：

安全注意事项

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

📄 许可证

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