内容
# ZXKOL — 社交数据为 AI 代理服务 🌐
<p align="center"><b>简体中文</b> · <a href="README.md">English</a></p>
> 一句话，整个网络的社交数据。查询创作者、热门内容、趋势图表和评论情感，涵盖 **18+ 社交平台** — 直接从 Claude、Cursor 或任何 MCP 客户端获取。
<p align="center">
<a href="https://github.com/kvalen-code/zxkol-skill/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/kvalen-code/zxkol-skill?style=social"></a>
<a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
<img alt="MCP" src="https://img.shields.io/badge/Model_Context_Protocol-ready-7c3aed">
<img alt="Platforms" src="https://img.shields.io/badge/platforms-18%2B-09C160">
</p>
<p align="center">
<a href="https://zxkol.com"><img alt="ZXKOL" src="assets/demo.png" width="800"></a>
</p>
**ZXKOL** 将 "查找抖音 10 万至 50 万关注者的美妆创作者" 转化为一次工具调用 — 无需爬虫，无需每个平台的 SDK。这是一个托管的 [模型上下文协议](https://modelcontextprotocol.io) 服务器，加上一个插入式技能：添加一个配置块，获取一个 API 密钥，您的代理即可从抖音、TikTok、小红书、哔哩哔哩、YouTube、Instagram 等平台拉取 KOL 数据、热门帖子、热榜、标签分析和 AI 评论洞察。
```text
您： 查找抖音美妆创作者（10 万至 50 万关注者）以及小红书当前的热门内容。
Claude： → creator_search(keyword="beauty", followerRange="100-500k")
→ content_search(keyword="beauty", platforms=["xiaohongshu"])
✓ 12 位创作者 + 8 篇热门笔记，总结完毕。
```
---
## ✨ 功能特点
- **一次调用，多平台支持** — 高级工具自动扩展到各个平台，并规范化结果以供 LLM 使用。
- **18+ 平台支持** — 抖音 / TikTok / 小红书（RED）/ 哔哩哔哩 / 快手 / 微博 / YouTube / Instagram / Twitter(X) / Threads / Reddit / LinkedIn 等。
- **1000+ 原始接口** — 通过语义 `find_route` + `rest_call` 可直接访问任意特定接口。
- **AI 评论洞察** — 评论的情感、痛点、卖点和内容角度分析。
- **与 MCP 无缝集成** — 适用于 Claude Desktop、Claude Code、Cursor、Continue、Windsurf、Cody 等。
- **按需付费** — 新用户享 **100 免费积分**；缓存命中 **半价**。
## 🛠 工具列表
### 高级工具 — 一行命令，自动扩展 + 规范化
| 工具 | 功能描述 | 支持平台 |
|---|---|---|
| `creator_search` | 查找创作者 / KOL（抖音星图官方商业数据） | 抖音 |
| `content_search` | 跨平台搜索热门内容 | 18 个平台 |
| `hot_list` | 实时热榜 / 趋势图表 | 13 个平台 |
| `content_detail` | 单个帖子详情（统计数据、作者、媒体） | 17 个平台 |
| `comment_insight` | AI 评论情感 & 洞察分析 | 14 个平台 |
| `hashtag_search` | 按关键词搜索标签 / 话题 | 7+ 个平台 |
| `hashtag_posts` | 标签下的热门帖子 | 7+ 个平台 |
| `douyin_index` | 抖音指数（关键词热度、品牌雷达、相似创作者） | 抖音 |
| `douyin_xingtu` | 抖音星图 KOL 资料 / 受众 / 报价 | 抖音 |
### 进阶工具 — 直接访问 1000+ 原始接口
| 工具 | 功能描述 |
|---|---|
| `find_route` | **语义搜索（前 5）** — 输入自然语言意图（EN/中文），获取最佳匹配的接口 + 必需参数 |
| `list_routes` | 浏览所有接口，支持 `platform` + `keyword` 过滤 |
| `rest_call` | 通过 `route` ID 调用任意接口（例如 `douyin/lives/room-products`）+ 参数 |
## 🚀 快速开始（2 分钟）
### 1. 获取 API 密钥
1. 在 **[zxkol.com](https://zxkol.com)** 注册 — 新用户享 **100 免费积分**。
2. 进入 **[Dashboard → API Keys](https://zxkol.com/dashboard/api-keys)** → **Create API Key**。
3. 复制您的 `zxk_live_...` 密钥（仅显示一次）。
### 2. 添加 MCP 服务器
**Claude Desktop** — 编辑 `~/.claude/mcp.json`（macOS/Linux）或 `%USERPROFILE%\.claude\mcp.json`（Windows）：
```json
{
"mcpServers": {
"zxkol": {
"type": "http",
"url": "https://zxkol.com/api/mcp",
"headers": { "Authorization": "Bearer zxk_live_YOUR_KEY" }
}
}
}
```
**Cursor** — `~/.cursor/mcp.json`，相同配置块。**Claude Code** — 项目根目录下的 `.mcp.json`。
> 更多可直接粘贴的配置示例见 [`examples/`](examples/)。
### 3. 提问
重启客户端并直接提问 — 工具将自动出现。
> "抖音今天的热门内容是什么？" · "分析这个 TikTok 视频的评论。" · "查找小红书母婴博主。"
## 🧩 作为 Claude Code 技能使用
更喜欢技能而非原始 MCP 配置？将 [`SKILL.md`](SKILL.md) 放入 `~/.claude/skills/zxkol/`（同时放置 [`mcp.json`](mcp.json)）。Claude Code 将自动识别何时调用 ZXKOL。
## 💳 定价
- 每次工具调用从密钥所有者的余额中扣除积分。
- **缓存命中半价** — 重复查询几乎免费。
- B2B（API 密钥）调用额外收取 1.5 倍费用。
- 完整定价： **[zxkol.com/pricing](https://zxkol.com/pricing)**
## 📚 链接
- 🌐 官网 — https://zxkol.com
- 📖 API 文档 — https://zxkol.com/docs/api
- 🔌 MCP 指南 — https://zxkol.com/docs/mcp
- 🗺 功能矩阵（18 平台 / 26 功能 / 1000+ 接口）— https://zxkol.com/about/coverage
---
## ⭐ 给本仓库点赞
如果 ZXKOL 帮助您避免编写另一个爬虫，**请点赞** — 这有助于其他开发者发现它。
---
## License
[MIT](LICENSE) — 适用于本仓库中的配置文件、文档和技能清单。ZXKOL 服务器端服务和数据受 [zxkol.com](https://zxkol.com) 条款约束。
