Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

feat: auto-install WeChat article tools during install (#80)

Pnantcd94706d3b6a
diff --git a/README.md b/README.md
index 4127b2f4..a1707deb 100644
--- a/README.md
+++ b/README.md
@@ -78,7 +78,7 @@ AI Agent 已经能帮你写代码、改文档、管项目——但你让它去
| 🎵 **抖音** | — | 视频解析、无水印下载链接获取 | 告诉 Agent「帮我配抖音」 |
| 💼 **LinkedIn** | Jina Reader 读公开页面 | Profile 详情、公司页面、职位搜索 | 告诉 Agent「帮我配 LinkedIn」 |
| 🏢 **Boss直聘** | Jina Reader 读职位页 | 搜索职位、向 HR 打招呼 | 告诉 Agent「帮我配 Boss直聘」 |
-| 💬 **微信公众号** | — | 搜索 + 阅读公众号文章(全文 Markdown) | 告诉 Agent「帮我配微信公众号」 |
+| 💬 **微信公众号** | 搜索 + 阅读公众号文章(全文 Markdown) | — | 无需配置 |
> **不知道怎么配?不用查文档。** 直接告诉 Agent「帮我配 XXX」,它知道需要什么、会一步一步引导你。
>
diff --git a/agent_reach/cli.py b/agent_reach/cli.py
index 8bb3a41e..1eb2f8c9 100644
--- a/agent_reach/cli.py
+++ b/agent_reach/cli.py
@@ -442,6 +442,79 @@ def _install_system_deps():
except Exception:
print(" ⬜ Could not configure yt-dlp JS runtime (YouTube may not work)")
+ # ── WeChat Articles (miku_ai + camoufox + wechat-article-for-ai) ──
+ _install_wechat_deps()
+
+
+def _install_wechat_deps():
+ """Install WeChat article reading and search dependencies."""
+ import subprocess
+
+ print("📦 Setting up WeChat article tools...")
+
+ # Check if already installed
+ has_camoufox = False
+ has_miku = False
+ try:
+ import camoufox # noqa: F401
+ has_camoufox = True
+ except ImportError:
+ pass
+ try:
+ import miku_ai # noqa: F401
+ has_miku = True
+ except ImportError:
+ pass
+
+ # Install Python packages
+ if has_camoufox and has_miku:
+ print(" ✅ WeChat Python packages already installed")
+ else:
+ pkgs = []
+ if not has_camoufox:
+ pkgs.extend(["camoufox[geoip]", "markdownify", "beautifulsoup4", "httpx"])
+ if not has_miku:
+ pkgs.append("miku_ai")
+ try:
+ cmd = [sys.executable, "-m", "pip", "install", "--break-system-packages", "-q"] + pkgs
+ subprocess.run(cmd, capture_output=True, encoding="utf-8", errors="replace", timeout=120)
+ # Verify
+ ok = True
+ try:
+ import importlib
+ if not has_camoufox:
+ importlib.import_module("camoufox")
+ if not has_miku:
+ importlib.import_module("miku_ai")
+ except ImportError:
+ ok = False
+ if ok:
+ print(f" ✅ WeChat Python packages installed ({', '.join(pkgs)})")
+ else:
+ print(f" ⚠️ Some WeChat packages failed to install. Try: pip install {' '.join(pkgs)}")
+ except Exception:
+ print(f" ⚠️ WeChat packages install failed. Try: pip install {' '.join(pkgs)}")
+
+ # Clone wechat-article-for-ai tool
+ tools_dir = os.path.expanduser("~/.agent-reach/tools")
+ wechat_dir = os.path.join(tools_dir, "wechat-article-for-ai")
+ if os.path.isfile(os.path.join(wechat_dir, "main.py")):
+ print(" ✅ wechat-article-for-ai tool already installed")
+ else:
+ try:
+ os.makedirs(tools_dir, exist_ok=True)
+ subprocess.run(
+ ["git", "clone", "--depth", "1",
+ "https://github.com/bzd6661/wechat-article-for-ai.git", wechat_dir],
+ capture_output=True, encoding="utf-8", errors="replace", timeout=60,
+ )
+ if os.path.isfile(os.path.join(wechat_dir, "main.py")):
+ print(" ✅ wechat-article-for-ai tool installed")
+ else:
+ print(" ⚠️ wechat-article-for-ai clone failed. Try: git clone https://github.com/bzd6661/wechat-article-for-ai.git " + wechat_dir)
+ except Exception:
+ print(" ⚠️ wechat-article-for-ai clone failed. Try: git clone https://github.com/bzd6661/wechat-article-for-ai.git " + wechat_dir)
+
def _install_system_deps_safe():
"""Safe mode: check what's installed, print instructions for what's missing."""
@@ -472,6 +545,29 @@ def _install_system_deps_safe():
else:
print(" All system dependencies are installed!")
+ # WeChat check (Python packages, not binaries)
+ has_camoufox = has_miku = False
+ try:
+ import camoufox # noqa: F401
+ has_camoufox = True
+ except ImportError:
+ pass
+ try:
+ import miku_ai # noqa: F401
+ has_miku = True
+ except ImportError:
+ pass
+ if has_camoufox and has_miku:
+ print(" ✅ WeChat article tools already installed")
+ else:
+ pkgs = []
+ if not has_camoufox:
+ pkgs.extend(["camoufox[geoip]", "markdownify", "beautifulsoup4", "httpx"])
+ if not has_miku:
+ pkgs.append("miku_ai")
+ print(f" ⬜ WeChat article tools not found")
+ print(f" Install: pip install {' '.join(pkgs)}")
+
def _install_system_deps_dryrun():
"""Dry-run: just show what would be checked/installed."""
@@ -492,6 +588,23 @@ def _install_system_deps_dryrun():
else:
print(f" 📥 {label}: would install via: {method}")
+ # WeChat
+ has_camoufox = has_miku = False
+ try:
+ import camoufox # noqa: F401
+ has_camoufox = True
+ except ImportError:
+ pass
+ try:
+ import miku_ai # noqa: F401
+ has_miku = True
+ except ImportError:
+ pass
+ if has_camoufox and has_miku:
+ print(" ✅ WeChat article tools: already installed, skip")
+ else:
+ print(" 📥 WeChat article tools: would install via: pip install camoufox[geoip] markdownify beautifulsoup4 httpx miku_ai")
+
def _install_mcporter():
"""Install mcporter and configure Exa + XiaoHongShu MCP servers."""
diff --git a/agent_reach/skill/SKILL.md b/agent_reach/skill/SKILL.md
index 6432af59..e8e631d5 100644
--- a/agent_reach/skill/SKILL.md
+++ b/agent_reach/skill/SKILL.md
@@ -7,12 +7,14 @@ description: >
Use when: (1) user asks to search or read any of these platforms,
(2) user shares a URL from any supported platform,
(3) user asks to search the web, find information online, or research a topic,
- (4) user asks to post, comment, or interact on supported platforms.
+ (4) user asks to post, comment, or interact on supported platforms,
+ (5) user asks to configure or set up a platform channel.
Triggers: "搜推特", "搜小红书", "看视频", "搜一下", "上网搜", "帮我查", "全网搜索",
"search twitter", "read tweet", "youtube transcript", "search reddit",
"read this link", "看这个链接", "B站", "bilibili", "抖音视频",
"微信文章", "公众号", "LinkedIn", "GitHub issue", "RSS",
- "search online", "web search", "find information", "research".
+ "search online", "web search", "find information", "research",
+ "帮我配", "configure twitter", "configure proxy", "帮我安装".
---
# Agent Reach — Usage Guide
@@ -157,4 +159,10 @@ for e in feedparser.parse('FEED_URL').entries[:5]:
- **Channel not working?** Run `agent-reach doctor` — shows status and fix instructions.
- **Twitter fetch failed?** Ensure `undici` is installed: `npm install -g undici`. Configure proxy: `agent-reach configure proxy URL`.
-- **Need to configure a channel?** Run `agent-reach doctor`, follow its instructions, or tell user to run the install guide.
+
+## Setting Up a Channel ("帮我配 XXX")
+
+If a channel needs setup (cookies, Docker, etc.), fetch the install guide:
+https://raw.githubusercontent.com/Panniantong/agent-reach/main/docs/install.md
+
+User only provides cookies. Everything else is your job.
diff --git a/docs/README_en.md b/docs/README_en.md
index 21c21206..6661b6a9 100644
--- a/docs/README_en.md
+++ b/docs/README_en.md
@@ -67,7 +67,7 @@ Update Agent Reach: https://raw.githubusercontent.com/Panniantong/agent-reach/ma
| 🎵 **Douyin** | Video parsing · Watermark-free download | mcporter | Via [douyin-mcp-server](https://github.com/yzfly/douyin-mcp-server), no login needed |
| 💼 **LinkedIn** | Jina Reader (public pages) | Full profiles, companies, job search | Tell your Agent "help me set up LinkedIn" |
| 🏢 **Boss直聘** | Jina Reader (job pages) | Job search, greet recruiters | Tell your Agent "help me set up Boss直聘" |
-| 💬 **WeChat Articles** | — | Search + read WeChat Official Account articles (full Markdown) | Tell your Agent "help me set up WeChat" |
+| 💬 **WeChat Articles** | Search + Read | Zero config | Search + read WeChat Official Account articles (full Markdown) ([wechat-article-for-ai](https://github.com/bzd6661/wechat-article-for-ai) + [miku_ai](https://github.com/GobinFan/Miku_Spider)) |
| 🔍 **Web Search** | Search | Auto-configured | Auto-configured during install, free, no API key ([Exa](https://exa.ai) via [mcporter](https://github.com/nicepkg/mcporter)) |
| 📦 **GitHub** | Read · Search | Zero config | [gh CLI](https://cli.github.com) powered. Public repos work immediately. `gh auth login` unlocks Fork, Issue, PR |
| 📺 **YouTube** | Read · **Search** | Zero config | Subtitles + search across 1800+ video sites ([yt-dlp](https://github.com/yt-dlp/yt-dlp) ⭐148K) |