Social Insight
БесплатноНе проверен多平台内容选题分析 MCP Server:10 个独立源热点聚合 · 跨源交叉验证 · 账号定位匹配 · 选题素材;默认少而准,单源话题折叠。12 个工具、521 个测试。Multi-platform content topic analysis MCP server.
Описание
多平台内容选题分析 MCP Server:10 个独立源热点聚合 · 跨源交叉验证 · 账号定位匹配 · 选题素材;默认少而准,单源话题折叠。12 个工具、521 个测试。Multi-platform content topic analysis MCP server.
README
多平台内容选题分析 MCP Server —— 热点聚合 · 跨源交叉验证 · 账号定位匹配
给定一个账号定位,告诉你今天有哪些热点值得做。
为什么需要它
热榜工具到处都是,但它们都停在同一层:告诉你什么在火。
创作者真正的问题是下一层:哪个跟我有关。
本项目补的就是这中间那一步 —— 把「全网热点」映射到「你的账号」, 并且给出可验证的匹配理由(命中了哪些词、属于哪个领域), 而不是一个无法追问的黑盒分数。
核心特性
1. 跨源交叉验证
单个热榜的排名是该站编辑口味的产物。 一个话题在多个互相独立的源上同时出现,才是它真的在火的证据。
| 级别 | 含义 |
|---|---|
confirmed |
≥3 个独立源 —— 强信号 |
likely |
2 个独立源 —— 值得做 |
single |
仅 1 个源 —— 可能是该站特有 |
镜像源不算数。 实测某聚合站的抖音榜与抖音官方榜前 10 条重合 7 条 —— 它是镜像。若当作独立源,等于把同一份数据数两遍, 会得出虚假的 confirmed。
所以每个源都标注 independence 键,同键只算一票。
2. 账号定位匹配
匹配度由三个正交信号加权,且分开报告命中证据:
| 信号 | 权重 | 说明 |
|---|---|---|
| 领域契合 | 0.45 | 热点属于你的领域吗 |
| 关键词命中 | 0.40 | 直接命中你的业务词吗(最强) |
| 形态契合 | ×1.15 | 适合你的内容形态吗(乘数,不是加分) |
| — | 减分 | 命中无关领域(如体育热点对科技号)会拉低 |
为什么分开报告:调用方能看到「命中了什么」, 从而判断合不合理、甚至推翻结论。黑盒分数无法验证。
刻意把「火」与「相关」分开:corroboration 表示热点强度,
score 表示与你多相关。很火但不相关的话题不该因为火就排前面。
3. 趋势追踪
每次查询自动落快照到 SQLite,可查:
- 某话题的历史(热度/排名变化)
- 近期持续在榜的话题(出现次数越多越稳)
配套的 snapshot 模块可独立运行,配合定时任务让快照规律累积。
4. 确定性,无内置 AI
所有分析都是确定性算法:排序、聚合、bigram 词频、情绪词典。 结果可复现、可验证。
不内置生成式 AI —— 调用方就是 LLM,服务器再调一次是重复付费 加黑盒化。MCP 的定位是数据面,「为什么火」的归因留给调用方。
安装
git clone https://github.com/zhaopq123/social-insight-mcp.git
# 国内镜像(Gitee,同步更新):https://gitee.com/zhaopq/social-insight-mcp
cd social-insight-mcp
python -m venv .venv
.venv/bin/pip install -e . # Linux/macOS
# .venv\Scripts\pip install -e . # Windows
依赖只有 mcp 与 httpx。
HTTP 传输另需 pip install fastmcp uvicorn。
配置账号
复制示例并改成你自己的账号:
cp accounts.example.json accounts.local.json
# 编辑 accounts.local.json
{
"accounts": {
"my-account": {
"display_name": "我的科技号",
"keywords": ["软件", "开发", "AI", "获客", "客户"],
"domains": ["software", "business"],
"platforms": ["douyin"],
"form": "image_text"
}
}
}
accounts.local.json 已被 .gitignore 忽略,不会进仓库。
也可用环境变量 SOCIAL_INSIGHT_ACCOUNTS 指定配置文件路径。
可用领域:software / retail / business / sports /
entertainment / finance / politics / tech_hardware
⚠️ 写 keywords 的关键经验:商业类账号必须同时写产品词与经营词。
只写「咖啡机、冰淇淋机」会漏掉「某品牌门店客流爆满」这类可做话题 —— 实测中这会让可用候选从 7 个掉到 0 个,而且看起来像「今天没热点」, 让人误以为数据源出问题了。
接入 MCP 客户端
stdio(本地)
{
"mcpServers": {
"social-insight": {
"command": "/path/to/.venv/bin/python",
"args": ["-m", "social_insight.server"]
}
}
}
streamable-http(远程)
HOST=0.0.0.0 PORT=8100 .venv/bin/python -m social_insight.http_server
{
"mcpServers": {
"social-insight": {
"type": "streamable-http",
"url": "http://<host>:8100/mcp"
}
}
}
工具
| 工具 | 说明 |
|---|---|
capabilities |
能力矩阵。建议任何操作前先调一次 |
hot_topics |
多源热榜聚合 + 交叉验证。默认「少而准」:topics 只放 confirmed+likely(≤20 条),single 话题折叠进 also_on_single(默认 5 条样本,single_limit=0 看全部) |
topic_match |
热点 × 账号定位匹配(核心) |
topic_material |
创作素材:热点标题 + 精准简要 + 时效 + 来源。按 query 取材,给 AI 读着写脚本用 |
trend |
热点趋势(依赖快照层) |
content_search 等 7 个 |
平台内容查询(需平台鉴权,见下) |
hot_topics 输出分层(2026-10-13 产品改造)
实测 204 条返回里 186 条是 single(91%),confirmed 只有 3 条—— 用户要「今天值得做的选题」,却被迫在 200 条各站榜单里自己挑。 筛选该由服务端做,所以默认输出改成两层:
| 字段 | 内容 |
|---|---|
topics |
只放被 ≥2 个独立源报道的话题(confirmed+likely),按「独立源数 → 最佳排名」排序,默认 ≤20 条(top_n 可调) |
also_on_single |
single 话题折叠:只给数量 + 前 5 条样本 + 说明。想看全部显式 single_limit=0 |
排序刻意不用热度值——跨源热度不可比(抖音 1200万 vs 今日热榜 4), 用它排序会让大体量源霸榜。跨源可比的只有「几个独立源在报」和「最好排名」。
topic_match 输出示例
{
"word": "某AI工具链发布新版本",
"score": 0.85,
"level": "strong",
"reasons": ["直接命中业务词:工具、AI", "属于你的领域「软件/科技」"],
"hit_keywords": ["工具", "AI"],
"corroboration": "single",
"source_count": 1,
"sources": ["某技术社区热榜"]
}
reliability 字段对结果可靠性做诚实评估,因为「没有候选」有几种
完全不同的成因,混在一起会误导人:
| 值 | 含义 |
|---|---|
weak-day |
今天全网热点确实与你的号不搭 —— 别硬凑 |
single-source-domain |
候选集中在单一垂直源。这是正常的:技术类在技术社区、美妆在小红书,受众不同,跨平台重合度天然低 |
mixed |
来源分散 |
empty |
完全没有。先检查是不是定位写窄了 |
平台支持现状
| 平台 | 热榜 | 内容查询 | 说明 |
|---|---|---|---|
| 抖音 | ✅ | ⚠️ 需签名 | 搜索接口要求 a_bogus 签名,本项目不自研(持续对抗项) |
| 小红书 | ✅ | ⚠️ 需登录 | 无匿名路径;签名依赖登录态 cookie |
| 微信视频号 | ❌ | ❌ | 官方无内容检索 API,仅占位 |
热榜全部无需登录 —— 这是本项目的设计前提。 需要鉴权的能力会返回带解释与替代路径的结构化错误,绝不静默返回空。
内置热点源
抖音 · 百度 · B站 · 掘金 · 今日热榜 · 微博 / 知乎 / 小红书 / 头条 / 36氪(经聚合)—— 共 10 个,互相独立。
设计原则
- 绝不静默失败 —— 能力缺失必须返回
reason+alternatives - 参数语义严格 ——
None(未传)与[](显式传空)必须区分 - 归一化只有一份实现 —— 三处各写一份会漂移,导致去重失效
- 不宣传未实现的能力 ——
capabilities从工具表动态读取 - 工具克制 —— 一个动词一个工具 + 参数化平台差异
开发
python -m pytest # 521 个测试
python -m pyflakes src/ tests/ # 应无输出
详见 CONTRIBUTING.md。
许可证
MIT。只做只读的公开数据聚合 —— 不登录、不发布、不互动、不绕过访问控制。
使用者应自行遵守目标平台的服务条款与当地法律法规。
Установить Social Insight в Claude Desktop, Claude Code, Cursor
unyly install social-insightСтавит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.
Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh
Или настроить вручную
Выполни в терминале:
claude mcp add social-insight -- uvx --from git+https://github.com/zhaopq123/social-insight-mcp social-insight-mcpПошаговые гайды: как установить Social Insight
FAQ
Social Insight MCP бесплатный?
Да, Social Insight MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Social Insight?
Нет, Social Insight работает без API-ключей и переменных окружения.
Social Insight — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Social Insight в Claude Desktop, Claude Code или Cursor?
Открой Social Insight на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
ARA
Generate images, video and audio from any AI agent — one connector.
автор: ARAVideo Analyzer
MCP server for video analysis — extracts transcripts, key frames with OCR, and annotated timelines from video URLs. Supports Loom and direct video files (.mp4,
автор: guimatheus92Omni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
автор: buildwithtazaYouTube
Transcripts, channel stats, search
автор: YouTubeEverArt
AI image generation using various models.
автор: modelcontextprotocolgpu-bridge/mcp-server
GPU inference API for LLMs, image and video generation, TTS, Whisper, embeddings, reranking and OCR, paid per use via x402 or an API key.
автор: gpu-bridgemerterbak/Grok-MCP
Access xAI's Grok API with agentic tool calling, image generation, vision and file support.
автор: merterbakSureScaleAI/openai-gpt-image-mcp
Image generation and editing with OpenAI's GPT image models.
автор: SureScaleAIYangLiangwei/PersonalizationMCP
Aggregate personal data from Steam, YouTube, Bilibili, Spotify, Reddit and other gaming, music, video and social platforms, with OAuth2 and token management.
автор: YangLiangweiAceDataCloud/MCPFlux
Flux image generation and editing from Black Forest Labs via the Ace Data Cloud API.
автор: AceDataCloudCompare Social Insight with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории media
