Threads Analytics
Track your Threads performance — views, likes, replies, reposts, quotes, and follower growth. Powered by Boring.
Security & Data Handling
- - MCP link is a credential: Your MCP Server URL (
https://boring.aiagent-me.com/mcp/t/xxxxx...) contains an embedded authentication token. Treat it like a password — do not share it publicly. - Token scope: The embedded token is read-only for analytics. It can only fetch performance metrics and account metadata. It cannot publish, delete, or modify any content on your social media accounts.
- Token storage: The token is stored server-side in Boring's database (MongoDB on DigitalOcean). It is never written to your local filesystem. You can regenerate or revoke it anytime at boring.aiagent-me.com/settings.
- Data flow: Analytics queries are sent from Boring's server (Google Cloud, us-central1) to the platform's API on your behalf. Only performance metrics are retrieved — no content is uploaded or modified.
- No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
- Third-party service: This skill relies on Boring, an open-source social media management tool. Source code: github.com/snoopyrain.
Prerequisites
- 1. Sign up at boring.aiagent-me.com with Google
- Connect Threads account via OAuth
- Get your MCP link: Go to Settings → copy your MCP Server URL (contains your auth token — treat it like a password)
- Add to Claude: Paste the MCP link as a Connector — no install, no API key needed
Available Tools
| Tool | Data Source | Best For |
|---|
| INLINECODE1 | Real-time platform API | Account-level overview (views, followers) |
| INLINECODE2 |
Real-time platform API | Per-post metrics (views, likes, replies, reposts) |
|
boring_get_posts_performance | Daily snapshots (collected at 2 AM) | Historical post performance over date ranges |
|
boring_get_publish_history | Boring database | Publishing history and status tracking |
Workflow
Step 1: List Accounts
Call boring_list_accounts and filter for threads platform.
Step 2: Determine What the User Wants
| User Request | Tool to Use |
|---|
| "How are my Threads doing?" | INLINECODE7 |
| "Show my best Threads posts" |
boring_get_video_analytics |
| "Threads performance this month" |
boring_get_posts_performance |
| "What did I post on Threads?" |
boring_get_publish_history |
Step 3: Fetch Data
Account-Level Performance
CODEBLOCK0
Per-Post Analytics (Real-Time)
CODEBLOCK1
Historical Post Performance (Snapshots)
CODEBLOCK2
Step 4: Present Results
Format the data clearly:
- - Account overview: Show views, followers in a summary table
- Post analytics: Rank posts by engagement (likes + replies + reposts)
- Historical: Show trends over time
Threads Metrics
| Metric | Description |
|---|
| INLINECODE11 | Post views |
| INLINECODE12 |
Post likes |
|
replies | Post replies |
|
reposts | Post reposts |
|
quotes | Post quotes |
|
followers_count | Account followers |
Error Handling
| Error | Solution |
|---|
| INLINECODE17 | MCP link may be invalid — regenerate it at boring.aiagent-me.com Settings |
| INLINECODE18 |
Run
boring_list_accounts to get valid IDs |
|
TokenExpired | Reconnect account at boring.aiagent-me.com |
| No data returned | Account may be newly connected — data collection runs daily at 2 AM |
Documentation
Full API docs: boring-doc.aiagent-me.com
Threads 数据分析
追踪您的 Threads 表现——浏览量、点赞数、回复数、转发数、引用数和粉丝增长。由 Boring 提供支持。
安全与数据处理
- - MCP 链接即凭证:您的 MCP 服务器 URL(https://boring.aiagent-me.com/mcp/t/xxxxx...)包含一个嵌入的身份验证令牌。请像对待密码一样对待它——不要公开分享。
- 令牌范围:嵌入的令牌对数据分析为只读。它只能获取性能指标和账户元数据。无法在您的社交媒体账户上发布、删除或修改任何内容。
- 令牌存储:令牌存储在 Boring 数据库(DigitalOcean 上的 MongoDB)的服务器端。它永远不会写入您的本地文件系统。您可以随时在 boring.aiagent-me.com/settings 重新生成或撤销它。
- 数据流:分析查询从 Boring 的服务器(Google Cloud,us-central1)代表您发送到平台的 API。仅检索性能指标——不会上传或修改任何内容。
- 无本地凭证:无需本地 API 密钥、环境变量或密钥。所有身份验证都嵌入在 MCP 链接中。
- 第三方服务:此技能依赖于 Boring,一个开源社交媒体管理工具。源代码:github.com/snoopyrain。
前提条件
- 1. 使用 Google 在 boring.aiagent-me.com 注册
- 通过 OAuth 连接 Threads 账户
- 获取您的 MCP 链接:前往设置 → 复制您的 MCP 服务器 URL(包含您的身份验证令牌——请像对待密码一样对待它)
- 添加到 Claude:将 MCP 链接粘贴为连接器——无需安装,无需 API 密钥
可用工具
| 工具 | 数据源 | 最佳用途 |
|---|
| boringgetperformance | 实时平台 API | 账户级概览(浏览量、粉丝数) |
| boringgetvideo_analytics |
实时平台 API | 单条帖子指标(浏览量、点赞数、回复数、转发数) |
| boring
getposts_performance | 每日快照(凌晨 2 点收集) | 历史帖子在日期范围内的表现 |
| boring
getpublish_history | Boring 数据库 | 发布历史和状态追踪 |
工作流程
第 1 步:列出账户
调用 boringlistaccounts 并筛选 threads 平台。
第 2 步:确定用户需求
| 用户请求 | 使用的工具 |
|---|
| 我的 Threads 表现如何? | boringgetperformance |
| 展示我最好的 Threads 帖子 |
boring
getvideo_analytics |
| 本月 Threads 表现 | boring
getposts_performance |
| 我在 Threads 上发布了什么? | boring
getpublish_history |
第 3 步:获取数据
账户级表现
boringgetperformance(
account_id=<账户ID>,
platform=threads,
period=week // day、week 或 month
)
单条帖子分析(实时)
boringgetvideo_analytics(
account_id=<账户ID>,
platform=threads,
limit=20 // 最多 100
)
历史帖子表现(快照)
boringgetposts_performance(
account_id=<账户ID>,
since=2025-12-01,
until=2025-12-31,
limit=20
)
第 4 步:呈现结果
清晰格式化数据:
- - 账户概览:在摘要表中显示浏览量和粉丝数
- 帖子分析:按互动量(点赞数 + 回复数 + 转发数)对帖子排序
- 历史数据:显示随时间变化的趋势
Threads 指标
帖子点赞数 |
| replies | 帖子回复数 |
| reposts | 帖子转发数 |
| quotes | 帖子引用数 |
| followers_count | 账户粉丝数 |
错误处理
| 错误 | 解决方案 |
|---|
| InvalidApiKey | MCP 链接可能无效——在 boring.aiagent-me.com 设置中重新生成 |
| InvalidAccountId |
运行 boring
listaccounts 获取有效 ID |
| TokenExpired | 在 boring.aiagent-me.com 重新连接账户 |
| 无数据返回 | 账户可能刚连接——数据收集每天凌晨 2 点运行 |
文档
完整 API 文档:boring-doc.aiagent-me.com