Skip to content
Back to search

wechat-search-weread

SkillWorks with Claude CodeGitHub

微信公众号文章搜索skill。通过微信读书搜一搜获取最新文章,返回标题/公众号/时间/简介/直链。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kanikig--wechat-search-weread/badge.svg)](/listings/kanikig--wechat-search-weread)

HTML

<a href="/listings/kanikig--wechat-search-weread"><img src="/api/listings/kanikig--wechat-search-weread/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 73 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: wechat-search-weread
  3. description: 微信公众号文章搜索skill。通过微信读书搜一搜获取最新文章,返回标题/公众号/时间/简介/直链。
  4. category: social-media
  5. ---
  6. # 微信读书公众号文章搜索
  7. > 📦 [GitHub](https://github.com/KANIKIG/wechat-search-weread) · [ClawHub](https://clawhub.ai/skills/wechat-search-weread)
  8. 通过微信读书搜一搜搜索微信公众号文章,返回完整数据(含 `mp.weixin.qq.com` 文章链接)。
  9. ## 触发条件
  10. 用户需要搜索微信公众号文章,且 Exa 和搜狗方案不满足需求时使用。
  11. > ⚠️ 微信读书官方 API (`/store/search` scope=2/4) 不支持公众号文章搜索(返回 `-2041`),详见 [api-limitations.md](references/api-limitations.md)。本浏览器方案是当前唯一可行途径。
  12. ## 前提
  13. - [agent-browser](https://github.com/vercel-labs/agent-browser) 已安装
  14. - 微信读书已登录(首次需扫码)
  15. - WSL 用户需 CDP 端口转发(见 [wsl-cdp-browser.md](references/wsl-cdp-browser.md)),用 `agent-browser connect "http://<IP>:9223"` 建连后无需 `--cdp` flag
  16. - **浏览器**:有 Edge 用 Edge,没有就 Chrome。CDP scroll 事件不触发时用 `window.dispatchEvent(new Event('scroll'))` 解决(见 [detailed-workflow.md](references/detailed-workflow.md) Step 3.2)。
  17. ## 流程概要(5 步,缺一不可)
  18. | 步骤 | 要点 |
  19. |------|------|
  20. | **1. 启动浏览器** | 非WSL自动;WSL 参考 [wsl-cdp-browser.md](references/wsl-cdp-browser.md) |
  21. | **2. 登录** | QR 扫码。首次 eval 触发的 QR 大概率过期 → 必须关闭弹窗→重新触发→提取(单 terminal 调用一气呵成)。**登录成功后删除 `/tmp/weread_qr.png`** |
  22. | **3. 搜索+滚动** | 先备份 weread 标签页(保持登录态)→ goto 搜索页 → eval 滚动到「暂无更多内容」(封顶500条) |
  23. | **4. 提取URL** | ① ≤50 篇:agent-browser eval 同步提取(最简单);② >50 篇:agent-browser eval 分批提取(每批 50,已验证 246 篇 100% 成功);③ execute_code + websockets 备选(有超时风险)。详见 [extraction-pattern.md](references/extraction-pattern.md) |
  24. | **5. 清理** | 回到微信读书首页 → 关闭搜索页、mp 链接等所有多余标签页,只保留一个 weread 页面 |
  25. > 🔴 **全部详细命令、代码块、陷阱表见 [references/detailed-workflow.md](references/detailed-workflow.md)**。
  26. ## 原理简述
  27. - **搜索 API**: 页面 XHR → `weread.qq.com/web/wx_search_broker_proxy`(需 session cookie)
  28. - **URL 获取**: DOM 无 href,点击 `.search_list_item` → Vue → `window.open(mp.weixin.qq.com/...)` → eval 拦截
  29. - **滚动加载**: 每次 scrollTo 触发 XHR 加载 ~45 篇新文章
  30. - **去重**: 每篇文章有唯一 `data-id`
  31. ## 结果投递
  32. 搜索完成后,**直接以最终回复输出结果**,系统会自动投递到当前对话。
  33. 输出格式(Step 4.4):搜到 X 篇 → 提取 Y 篇 → Z 篇有链接(成功率 N%)+ Top 10 列表,完整数据存 /tmp/urls.json。
  34. 🔴 **链接必须从 `/tmp/urls.json` 读取,严禁从控制台输出或记忆中复制 URL**。控制台输出会截断长 URL(丢失 `chksm` 或 `#rd`),导致微信打开显示"参数错误"。正确做法:
  35. ```bash
  36. python3 -c "
  37. import json
  38. with open('/tmp/urls.json') as f:
  39. data = json.load(f)
  40. for i, r in enumerate(data[:10]):
  41. print(f\"{i+1}. [{r['title']}]({r['url']}) — {r.get('source','')} · {r.get('date','')}\")
  42. "
  43. ```
  44. ## References
  45. - `references/detailed-workflow.md` — **完整操作手册**:Step 1-5 全部命令、QR 流程、滚动策略、URL 提取代码
  46. - `references/extraction-pattern.md` — Python 提取代码模板(execute_code 中直接执行)
  47. - `references/cdp-patterns.md` — CDP 交互模式参考
  48. - `references/wsl-cdp-browser.md` — WSL 配置指南
  49. - `references/api-limitations.md` — 微信读书 API 限制说明
  50. - `references/llm-filter-pattern.md` — LLM 语义筛选模式:搜索噪音过滤(替代关键词黑名单)
  51. - `references/topology-optimization-filter.md` — 拓扑优化领域专用筛选模式:已验证的排除正则、陷阱、持久化格式
  52. - `references/edge-cdp-scroll-issue.md` — CDP scroll 事件不触发问题:诊断、验证方法、解决方案
  53. - `scripts/search_weread.py` — 备选/调试脚本(非主流程)
README.md · README · 58 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # wechat-search-weread
  2. [![GitHub](https://img.shields.io/badge/GitHub-KANIKIG%2Fwechat--search--weread-blue?logo=github)](https://github.com/KANIKIG/wechat-search-weread)
  3. [![ClawHub](https://img.shields.io/badge/ClawHub-wechat--search--weread-orange)](https://clawhub.ai/skills/wechat-search-weread)
  4. 通过微信读书搜一搜,搜索微信公众号文章。返回**标题、公众号、发布时间、简介**以及 **`mp.weixin.qq.com` 直链**。
  5. > ⚠️ **本项目只负责搜索和获取文章链接,不包含抓取文章正文内容。**
  6. ## 和其他方案比
  7. | 方案 | 文章时效 | 有发布日期 | 有直链 | 需要 |
  8. |------|---------|-----------|--------|------|
  9. | **微信读书搜索(本项目)** | ✅ 最新 | ✅ | ✅ | 微信扫码 |
  10. | Exa (mcporter) | ❌ | ❌ | ✅ | API Key |
  11. | 搜狗微信搜索 | ❌ ~2021 | ✅ | ✅ | 无 |
  12. **唯一能同时拿到「最新文章 + 发布日期 + 直链」的方案。**
  13. ## 使用方式
  14. 通过 Agent 对话触发。在聊天窗口告诉 Agent 你要搜什么即可:
  15. > "搜一下最近关于大模型的公众号文章"
  16. > "微信搜索 OpenAI"
  17. Agent 会自动调用本 Skill 完成搜索。
  18. **如果微信读书还没登录**,Agent 会把登录二维码发到聊天窗口,微信扫码即可。登录后继续搜索,全程自动。
  19. 搜索完成后,你会收到:
  20. ```
  21. 关键词 公众号文章搜索
  22. 搜到 258 篇 → 提取 258 篇 → 252 篇有链接(成功率 98%)
  23. 🔥 Top 10:
  24. 1. [文章标题](http://mp.weixin.qq.com/s/...) — 2小时前
  25. 2. [文章标题](http://mp.weixin.qq.com/s/...) — 昨天
  26. ...
  27. ```
  28. 默认展示前 10 篇,完整数据保存在 `/tmp/urls.json`。
  29. ## 原理简述
  30. 微信读书搜索结果页面本身不暴露文章链接。点击文章卡片时页面通过 `window.open` 打开目标文章。本项目通过浏览器自动化拦截这个操作,批量获取所有文章的真实 `mp.weixin.qq.com` 链接。
  31. ## 依赖
  32. - [agent-browser](https://github.com/vercel-labs/agent-browser) — 浏览器自动化控制
  33. ## 声明
  34. - 本项目**仅搜索公众号文章并获取链接**,不抓取正文
  35. - 需要微信扫码登录,session 过期后需重新扫码

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.