qbu11/wechat-article-spider

一条命令安装

npx @qbu11/wechat-agent-kit install

在首个 npm 版本发布前，也可以直接使用固定的 GitHub 版本：

npx github:qbu11/wechat-article-spider#v0.2.1 install

安装器会先展示写入计划并请求确认，将 3 个标准 Agent Skills 安装到 Claude Code、Codex 和通用 .agents/skills 目录。它没有 postinstall，支持 --dry-run、项目级安装和安全卸载。

# 先预览，不写文件
npx @qbu11/wechat-agent-kit install --dry-run

# 只安装到当前项目的 Codex skills
npx @qbu11/wechat-agent-kit install --agent codex --scope project --yes

要求 Node.js 22.13 或更新版本；推荐当前 Node.js 24 LTS。

为什么它足够简单

你的 Agent → 3 个 SKILL.md → wechat-agent JSON CLI → 一个本地 SQLite 文件

没有常驻服务，没有独立数据库，没有自动运行的后台任务。SQLite 是 Node.js 自带能力，CLI 会自动创建和维护；它只用来保存订阅、索引文章和同步状态。

所有命令把结构化 JSON 写到 stdout，便于任何 Agent 或脚本稳定调用。

30 秒上手

安装后可以直接对 Agent 说：

搜索最近关于 OpenAI 的微信公众号文章，并给出原文链接。

阅读这篇微信文章，概括主要观点并保留来源信息。

订阅这个 Atom 地址，然后同步一次并列出新增文章。

也可以直接使用 CLI：

# 关键词搜索：快速返回文章 JSON 和当前可用链接
npx -y @qbu11/[email protected] query --keywords "OpenAI" --scope hybrid --limit 10 --json

# 指定公众号 + 时间段：与普通关键词搜索使用不同的明确意图
npx -y @qbu11/[email protected] query --account "虎嗅APP" --after 2026-08-01 --before 2026-08-15 --scope hybrid --limit 20 --json

# 读取微信原文
npx -y @qbu11/[email protected] read --url "https://mp.weixin.qq.com/s/..." --content full --json

# 持久订阅一个明确的 Feed；更新只在 sync 时发生
npx -y @qbu11/[email protected] subscribe --feed-url "https://example.com/wechat.xml" --label "我的订阅" --json
npx -y @qbu11/[email protected] sync --json
npx -y @qbu11/[email protected] list --json

打包的 Skills 始终使用固定版本的 npx 调用，不依赖全局安装的裸命令。查看完整命令：

npx @qbu11/wechat-agent-kit --help

query 默认不抓取每篇正文，而是并行查询本地索引与网络来源，尽快返回紧凑 JSON。--keywords 是跨公众号的 keyword-search；--account 加明确日期边界是单一公众号的 account-window。远端公众号时间窗只是 best-effort，空结果不代表该号没有发文；要得到可持续、可重复查询的覆盖，应订阅已验证 Feed、执行 sync 后查本地索引。每条结果分别提供 originalUrl 与 discoveryUrl：只有主机名严格为 mp.weixin.qq.com 的链接才能称为微信原始链接，搜狗跳转和其他主机只能作为发现来源。完整的 Skill 流程图与数据处理规程 解释了意图路由、去重、来源和同步规则。

订阅边界

微信公众号没有面向此用途的稳定公开订阅接口。因此，本项目只持久订阅你明确提供、并经过内容验证的 RSS 2.0、Atom 或 JSON Feed 地址。搜索到的公众号名称或 ID 不会被猜测成订阅源。

• search --scope global 依赖搜狗微信搜索，可能遇到验证码、限流或结果变化；工具会明确报错，不绕过访问控制。
• read 支持公开的微信原文链接；已删除、受限或需验证的页面会返回对应状态。
• sync 是显式操作。需要定时更新时，请让你信任的外部调度器调用固定的 npx -y @qbu11/[email protected] sync --json。
• Feed 的覆盖范围和延迟由 Feed 提供方决定，本项目不声称完整收录某个公众号。
• 公共 Feed 可用 --feed-url；带私密 query token 的 URL 必须从用户管理的秘密源通过 --feed-url-stdin 输入，不能把字面值写进 Agent 命令、argv 或日志。

本地与安全

• 文章和订阅保存在操作系统应用数据目录的单个 wechat-agent.sqlite 中；可用 WECHAT_AGENT_DATA_DIR 改变位置。
• 网络访问会在每次请求前校验并拒绝已解析出的私网目标，同时拒绝危险重定向和超大响应；Node 原生 fetch 无法彻底消除 DNS 重绑定时间窗，详见 安全策略。文章、Feed 与搜索内容始终按不可信输入处理。
• 安装器只管理自己写入且未被用户修改的文件；覆盖前会备份，卸载不会删除已修改内容。
• 不在日志或结果中输出 Cookie、浏览器配置与认证头。

详见 安全策略、隐私说明、架构说明 与 健壮性测试指南。

开发

npm ci
npm run test:robustness
npm run validate
npm run build
npm run pack:check

仓库保留了原来的 Python wechat-spider，用于需要扫码登录微信公众平台后台的旧流程；它不是新 Agent Skills 的运行依赖。迁移和凭证注意事项见 Python 旧版说明。

欢迎阅读 贡献指南。本项目基于 MIT License 开源，仅用于合法、合规的内容检索与个人信息管理；请遵守来源站点条款与著作权规则。