# ContentRadar MCP Server

把 ContentRadar 的**查数据 + 低危写内容**能力，做成 AI 客户端（Claude Desktop / Claude Code / Cursor）的工具。让你直接跟 AI 说「最近谁起量了 / 把这条记进选题池」，它自己调 ContentRadar。

本地运行、通过 stdio 通信；你的令牌只留在你自己电脑上，不经过任何中间服务。

## 装 3 步

**1. 建一个访问令牌**
到 ContentRadar 的 `/developers` 页新建一个令牌：
- 只想让 AI **查数据** → 选「只读」（最安全，推荐）。
- 还想让 AI 帮你**写知识库 / 建选题** → 选「读+写内容」。
- 复制那串 `crt_...`（只显示一次，和密码一样保管）。

**2. 在客户端配置里粘一段**
以 Claude Desktop 为例，编辑其 MCP 配置，加：
```json
{
  "mcpServers": {
    "contentradar": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/obb396193-code/contentradar-mcp", "contentradar-mcp"],
      "env": { "CONTENTRADAR_PAT": "crt_你的令牌" }
    }
  }
}
```
（`uvx --from git+... contentradar-mcp` 从公开仓免安装直跑，无需先装。自建部署再加一行
`"CONTENTRADAR_API_BASE_URL": "https://你的域名"`，默认连 staradar.xyz。）

**3. 重启客户端** → 生效。跟 AI 说「看看我的监控大盘」试试。

## 有哪些工具

15 个（13 读 + 2 写内容）：大盘 / 起量榜涨粉榜 / 博主列表·详情 / 作品列表·详情 / 拆解报告 /
技法·交叉分析 / 搜自己知识库 / 选题池 / 任务状态 / 导出数据；写：写知识库 / 建选题。

**做不到的（设计如此）**：花钱操作（触发拆解 / 抓单条 / 同步博主 / AI 生成）、下载视频音频、
任何账号 / 成员 / 密钥 / 删除操作——这些 MCP 里没有对应工具。权限还由令牌档位在服务端兜底：
只读令牌打写接口会被拒。

## 令牌安全
配置文件里是明文令牌，和密码同级保管。丢了或换电脑，去 `/developers` 一键吊销即可。