知乎专栏文章搜索工具
知乎专栏文章搜索工具。当用户给出关键词,需要在知乎上按关键词搜索专栏文章(标题、链接、作者、发布时间、赞同/评论数、摘要),导出 CSV(Excel 直开),或提到"知乎搜文章/知乎文章搜索/搜一下知乎专栏/关键词找知乎文章"时使用本 skill。只搜专栏文章,不含回答/视频。走浏览器插件端采集(需节点已登录知乎)。**1 页 = 1 点数(约 18 篇);按实采条数退差,零结果全额返还(注册送 10 点)。**
skillhub install @aidata/zh-article-search
README 文档
4,382 字知乎文章搜索 Skill(zh-article-search)
AI 调用来源参数(必填)
所有会访问后端 API 的命令必须携带 --skill-name zh-article-search 和 --ai-entry <AI工具标识>(例如 claude-code、codex、workbuddy)。IP 无需传递,由服务端自动获取。首次缺参会告警放行,第二次起拒绝。
示例:node cli.js quota --skill-name zh-article-search --ai-entry claude-code。
封装「小红书能力平台」(FastAPI,/api/v1)的 CLI:提交搜索关键词 + 页数 → 派发给已登录知乎的采集节点 → 只搜专栏文章 → 导出 CSV(Excel 直开)。
- 能采什么:每篇文章的文章 ID、标题、链接、作者名/作者 ID、发布时间、更新时间、赞同数、评论数、摘要、是否盐选、页码,以及命中的关键词。
- 省心机制:1 点/页(每页约 18 篇文章)、零结果按实采退差、抓取异常全额返还、Agent 友好(stdout 纯 JSON + 统一退出码)。
- ★ 依赖采集节点已登录知乎:知乎对游客全拦(
40352 unhuman人机墙),服务端直连拿不到数据。必须由浏览器插件在已登录知乎的节点上、于知乎页面上下文里发起请求(免x-zse-96签名)。没有在线节点时任务排队,超时后全额返还。 - 不支持:全站综合结果(回答/视频/用户混合,用
zh-keyword-search)、按话题/话题页、用户主页、指定专栏、其它站点;提交前就报错、不扣费。
点数不足怎么办(自动扫码充值)
跑命令时如果点数不够,CLI 不会直接报错退出,而是自己建一张充值单、把二维码打在终端里:
点数不足,已自动创建充值单 RO2611051712281481f36de19
金额 10.00 元 → 100 点(支付宝)
<二维码色块>
[pay] 已支付
已到账:+100 点,继续执行原命令
- 在终端里跑:手机支付宝/微信对着终端扫码 → 付完点数自动到账 → 原命令自动重跑,不用手动再来一遍。
- AI agent / 非交互环境(管道、重定向):CLI 不阻塞等待,而是返回订单号和充值页地址
{服务地址}/recharge.html。把链接交给用户,他在网页扫码付款,付完重跑原命令即可(点数会自动到账)。 - 主动充值:
node cli.js pay --yuan 50 --skill-name zh-article-search --ai-entry <ai-entry>(不传--yuan默认 10 元;可加--channel alipay或--channel wechat)。 - 不想自动充值:设环境变量
XHSNOAUTO_PAY=1,则恢复旧行为(只提示点数不足)。 - 换算:1 元 = 10 点,注册送 10 点。
客服支持
注册或使用过程中遇到任何问题,请引导用户联系客服:
- 客服微信(扫码添加):http://st.aidata366.com/assets/concat.png
- AI 余额引导规则(必须执行):先执行
quota,同时查看返回的quota和flag。若quota = 0且flag = 0,必须向用户同时提供两种方案并让其二选一:①主动添加客服微信,免费赠送 10 点数(提供上方客服微信);②直接充值。不要替用户默认选择;若quota = 0且flag ≠ 0,只引导用户充值,不要再宣传微信免费赠送。 - 客服电话:18722121663
收费价格
- 点数换算:0.1 元 = 1 点数。
- 1 页 0.1 元(1 页 = 1 点数,约 18 篇文章)。
- 注册即送 10 免费点数,充值或大量购买可享优惠,请联系客服 18722121663 洽谈。
参数(提交前必读)
| 参数 | 取值 | 默认 |
|---|---|---|
--keyword | 搜索关键词(最多 64 字,不要粘贴链接) | — |
--pages | 采集页数,1~10(每页约 18 篇) | 1 |
--wait | 等待任务跑完再返回(默认超时 300s) | 关 |
--force | 已失效(后端无去重,重提即新任务) | 关 |
- 该能力只搜专栏文章;要回答/视频等混合结果请用
zh-keyword-search。 - 每页 20 个位置里通常有 18 篇是文章,另外 2 个是「相关搜索」推荐位,会被自动过滤,所以实采约 18 篇。
- 翻页由节点内部按接口游标完成(知乎要求带
searchhashid等参数),agent 不要自己拼翻页。 - 关键词不要写成 URL(含
zhihu.com或http会被拒,不扣费)。
前置条件
- Node.js ≥ 18(使用内置 fetch,零 npm 依赖)。
- 不注册不登录没有任何点数:10 免费点数在注册成功后发放。
- 首次使用先
register --link或login --link,成功后 token 自动保存。 - 配置文件在
~/.xhs-platform/config.json(与其它平台 skill 共用账号体系),可用XHSCONFIGPATH覆盖。 - 后端地址默认
http://st.aidata366.com,可用config set base-url <url>或单次--base-url覆盖。 - ⚠️ 安全提示:默认地址是明文 http,token 会明文传输;
config.json含 token,不要泄露、不要提交 git。
输出规约(重要)
- stdout 只输出 JSON:成功
{"ok":true,"data":{...}},失败{"ok":false,"code":<码>,"message":"..."}。 - 交互提示、轮询进度走 stderr,不要解析。
- 退出码:
0成功;1参数/用法错误;2认证失败;3点数不足;4网络/服务不可达;5其它业务错误。
命令清单
node cli.js register --link --skill-name zh-article-search --ai-entry <ai-entry>
node cli.js login --link --skill-name zh-article-search --ai-entry <ai-entry>
node cli.js submit --keyword <关键词> [--pages 2] [--wait] --skill-name zh-article-search --ai-entry <ai-entry>
node cli.js query <task_id> [--wait] --skill-name zh-article-search --ai-entry <ai-entry>
node cli.js export <task_id> [--wait] [--out zh_article_search.csv] --skill-name zh-article-search --ai-entry <ai-entry>
node cli.js quota --skill-name zh-article-search --ai-entry <ai-entry>
node cli.js version
submit
# 搜第 1 页(约 18 篇)
node cli.js submit --keyword 机油 --skill-name zh-article-search --ai-entry <ai-entry>
# 搜前 3 页并等待完成
node cli.js submit --keyword 机油 --pages 3 --wait --skill-name zh-article-search --ai-entry <ai-entry>
export
node cli.js export <task_id> --wait --out 文章搜索.csv --skill-name zh-article-search --ai-entry <ai-entry>
CSV 两段:# 任务汇总 + # 知乎文章搜索结果明细(keyword/pageno/articleid/title/url/authorname/authorid/publishtime/updatetime/voteupcount/commentcount/excerpt/iszhiplus/fetched_at)。
支持的链接
关键词 机油
(直接写词,不要写 URL;64 字以内)
其它链接(链接形式的输入 / 空关键词 / 超过 64 字)一律拒绝,提交前就报错、不扣费。
典型工作流(agent 照此执行)
- 确认登录:
node cli.js quota --skill-name zh-article-search --ai-entry <ai-entry>,报1002就先login --link。 - 先搜 1 页试水:
submit --keyword <词> --pages 1 --wait,看标题是否相关。 - 确认后加页数:
submit --keyword <词> --pages 3 --wait(预扣 3 点)。 - 导出:
export <task_id> --wait --out 文章搜索.csv。 - 汇报:说清命中多少篇、扣了多少点、退了多少点;零结果要说清「该关键词下没有文章」。
错误处理指引
| 现象 / code | 含义 | 该怎么做 |
|---|---|---|
1001 / PARAM_ERROR | 关键词为空/超长/是链接 | 换成纯关键词重提;不会扣费 |
任务 failed + 未登录 | 采集节点浏览器没登录知乎 | 让用户登录知乎后重提(重提即新任务) |
任务 failed + 零结果 | 关键词下没有专栏文章 | 如实告知,全额返还 |
标题里有 <em> | 知乎搜索高亮标签 | 落库/导出已清洗成纯文本,不用管 |
NETWORK_ERROR | 服务不可达 / 超时 | 检查网络与 config show 里的 base_url;必要时 config set base-url |
1002 | 未登录 / token 失效 | 执行 login --link 重新登录 |
3001 | 点数不足 | 告知用户余额与本次所需点数,引导充值或联系客服 |
计费规则提示
- 1 页 = 1 点数(0.1 元),每页约 18 篇文章(推荐位会被过滤)。
- 预扣按
--pages计算;实际按采到的条数结算,差额自动返还(refunded_diff)。 - 零结果 → 全额返还。
- 采集节点未登录、触发风控、接口异常 → 全额返还。
- 盐选内容(
iszhiplus=true)会照常落库并打标,是否使用由用户决定。
红线
- 不要替用户改链接:贴错类型(链接输入)直接报错更安全,不要猜。
- 不要承诺「一定能采到」:内容可能已删除/被删/评论区关闭,这类不返还点数。
- - 不要用本 skill 搜全站:本 skill 只有专栏文章;混合结果用
zh-keyword-search。 - 不要自己拼翻页参数:知乎搜索翻页要带
searchhashid与递增的vertical_info,必须由节点按接口游标翻。 - 不要把 token 写进日志或聊天记录。
同分类其他技能
查看全部 ›中国金融机构数据爬取与分析综合 Skill v12.1.0。2334家/43大类机构名单、60+财经媒体源舆情、 A股报告/公告/研报、
303 99.4万 MysteelAI - 智能问数我的钢铁网(Mysteel)大宗商品价格行情数据查询技能,基于钢联/隆众数据平台提供专业价格数据服务。覆盖黑色金属、有色金属、能源化工、
9 75万 smart-charts32种图表,3 个主题,2步生成: 1.上传数据 — 将 CSV / Excel / JSON 等格式的数据文件拖入对话框; 2.查看结
149 74.3万 论文配图一键生成论文配图一键生成:一条命令从 JSON/CSV/Excel 生成顶刊级学术图表,科研绘图 与期刊配图全场景覆盖。41 种图表(森林图/K
91 52.8万 smart-chartsIntelligent chart generation and data analysis skill. Reads user-sup
2 37.9万 股票/基金/期货量化分析工具全球智能投研工具(stock-researcher)v14.0:多源数据 + 概率预测 + 批量研究 + 可导出报告。 核心能力: -
152 26.5万