zhiwei

为什么需要知微？

AI Agent 能帮你写代码、读英文网页——但中文互联网对它几乎是盲区：

• 📖 "看看知乎上大家怎么评价 xx" → 读不了，问题下的高赞回答拿不到

• 🔥 "微博这两天在爆什么" → 搜不了，热搜数据没有干净的获取通道

• 📰 "把这篇公众号深度文章给我读一下" → 打不开，正文淹没在 HTML 里

• 就算读到了，也只有原文，没有观点聚合、评论树、热点脉络这些中文特有的结构

Agent Reach 解决了 Twitter/Reddit/B站/小红书的"能读到"；知微专注它没覆盖的中文深度：知乎、微博、公众号的原生提取 + 深度加工——不是把原文丢给你，而是把观点结构喂给 agent。

Related MCP server: Unified Search MCP Server

深度层：读得到，更要读得透

两个引擎都是确定性规则、无 LLM 依赖、可离线复现——确定性的部分做扎实，主观综合留给调用方 agent。这是"半成品哲学"：我们不做黑盒总结，做结构化的思考素材。

输出长什么样

知乎热榜（发布日真实抓取）：

| # | 话题 | 热度 | 回答数 |
|---|---|---|---|
| 1 | [什么东西被发明出来后，莫名其妙地违背了它的用途？](https://www.zhihu.com/question/2083219865272374442) | 852 万热度 | 241 |
| 2 | [LPL 2026 冒泡赛决赛 iG 3:1 淘汰 JDG 夺得最后一张世界赛门票，如何评价这场比赛？](…) | 694 万热度 | 132 |

观点聚合（zhihu-digest，演示数据）：

共聚合 4 个回答、11000 赞。焦点关键词：政策、数据

## 👍 支持方 — 2 条（条数 50.0% · 赞数 55.5%）
> **甲**（5200 赞）：这个政策完全正确，确实是多年来最务实的方案

## 👎 反对方(质疑) — 1 条（条数 25.0% · 赞数 28.2%）
> **乙**（3100 赞）：我反对这个方案，因为它根本不解决问题，恰恰相反…

## 📊 事实/中立 — 1 条（条数 25.0% · 赞数 16.4%）
> **丙**（1800 赞）：根据公开资料，2025 年试点城市的统计显示，参与率增长 35%…

配置 ZHIWEI_LLM_* 环境变量后，zhihu-digest --llm 会追加阵营命名、分歧提炼与总结（失败自动降级为纯规则输出）。

生态位：与 Agent Reach / markitdown 的关系

三者互补不冲突：Agent Reach 负责"连上"，markitdown 负责"文件"，知微负责"中文内容读透"。

装好即用（一句话安装）

把下面这句复制给你的 Agent（Claude Code / Cursor / OpenClaw …）：

帮我安装知微：https://raw.githubusercontent.com/0718lol/zhiwei/main/docs/install.md

Agent 会自己完成安装、验证、并汇报各渠道状态。

能力一览

所有命令支持 --json（结构化输出）与 --limit。

给 Agent 接上 MCP

pip install "zhiwei @ git+https://github.com/0718lol/zhiwei.git" "mcp>=1.2"

.mcp.json（Claude Code）：

{
  "mcpServers": {
    "zhiwei": { "command": "zhiwei-mcp", "args": [] }
  }
}

提供 6 个工具：zhihu_hot_list / zhihu_question / weibo_hot_search / weibo_post / wechat_article / doctor。

设计原则

只做深度，不重复造轮子。 每个 backend 是一个纯函数，渠道维护"首选 + 备选"有序列表——平台一改版，调整顺序而不是重写代码；doctor 永远告诉你当前走的哪条路。反爬世界里"坏了"是常态，诚实报告比假装可用重要。

合规与隐私

• ✅ 只读公开内容，不携带、不存储任何登录态/Cookie

• ✅ 全部本地运行，没有任何数据上传

• ✅ 尊重 robots 与平台风控：被拦截即如实报告，不做对抗性绕过

• ⚠️ 知乎问答接口受 IP 信誉影响（数据中心 IP 易触发风控），详见 doctor 输出

• 仅供个人学习与调研使用，请遵守各平台用户协议

Roadmap

✅ 已完成

• v0.1 渠道层：知乎热榜（双后端）· 微博热搜（双后端）· 微博博文 · 公众号单篇解析 · doctor 自诊断 · CLI + MCP 双形态

• v0.1 深度层：观点聚合（立场图谱/核心句/焦点关键词）· TextRank 摘要（公众号 + 关键数据点）

• v0.1.1 产品层：MCP 工作流 prompts（舆情晨报 / 公众号深读）· zhiwei://doctor 资源 · --llm 可选增强（安全降级）

🎯 近期执行清单（v0.2 前）

• 国内网络实测：zhiwei doctor 全绿（微博双后端、知乎问答），真实公众号文章跑通 wechat-summary

• 恢复 CI：workflow 因推送权限暂存于 docs/ci.yml.example，恢复方法见其提交信息

• 发布 PyPI：pip install zhiwei / uvx zhiwei-mcp，安装摩擦降一个数量级

• 提交 MCP 目录：glama / smithery / mcp.so / PulseMCP，以及 awesome-claude-code 类清单

• 共生渠道：向 Agent Reach 提议成为其知乎/微博/公众号的官方后端（借 8 万+星分发）

🚧 v0.2

• 公众号发现与搜索（搜狗通道优先）

• 微博评论树（登录态作为用户自供的可选能力引入，含免责与本地存储设计）

• 观点聚合 LLM 档打磨：阵营命名质量、分歧图谱、可复现的 prompt 版本管理

• v0.2 热点时间线（一）：本地 SQLite 快照 + 话题演化回放（zhiwei snapshot / zhiwei timeline，每小时定时运行积累数据）

🔭 v0.3+

• 热点时间线产品化：一个事件在知乎/微博的演化脉络回放

• 静态 demo 页：观点聚合的可视化展示（产品说明书）

• 成为"中文互联网的 agent 数据层"：渠道插件化，欢迎社区贡献新平台

网络现实：知乎热榜与公众号站点全球可达（海外 IP 已验证）；知乎问答与微博的接口对数据中心/海外 IP 有风控，国内住宅网络体验完整。zhiwei doctor 会如实报告你所处网络的每条路通不通。

贡献：欢迎提交新渠道后端（一个渠道 = 一个模块 + 多后端列表 + doctor 检查项）。红线：只读公开内容、不碰登录态对抗、被拦截时诚实报告。

English (brief)

ZhiWei is a Chinese-web depth layer for AI agents: Zhihu (hot list, Q&A), Weibo (hot search, posts), WeChat Official Account articles — public content only, no login states, local-first, LLM-optimized markdown output, CLI + MCP server. Install: pip install "zhiwei @ git+https://github.com/0718lol/zhiwei.git". Paste the one-liner in docs/install.md to your agent and it self-installs.

License

MIT © 2026 0718lol