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.

[codex] update AI Agent contact CTA (#449)

Pnante87bcdb17713
diff --git a/README.md b/README.md
index 980858d3..35c967ea 100644
--- a/README.md
+++ b/README.md
@@ -263,18 +263,6 @@ agent-reach uninstall --keep-config
---
-## 贡献
-
-这个项目是纯 vibe coding 出来的 🎸 可能会有一些不完美的地方,如果遇到问题请多多包涵。有 bug 尽管提 [Issue](https://github.com/Panniantong/agent-reach/issues),我都会尽快修复。
-
-**想要新渠道?** 直接提 Issue 告诉我们,或者自己提 PR。
-
-**想在本地加?** 让你的 Agent clone 下来改就行,每个渠道就是一个独立文件,加起来很简单。
-
-[PR](https://github.com/Panniantong/agent-reach/pulls) 也随时欢迎!
-
----
-
## ⭐ 为什么值得 Star
这个项目我自己每天在用,所以我会一直维护它。
@@ -289,70 +277,31 @@ Star 一下,下次需要的时候能找到。⭐
---
-## 常见问题 / FAQ
-
-<details>
-<summary><strong>AI Agent 怎么搜索 Twitter / X?不想付 API 费用</strong></summary>
-
-Agent Reach 使用 [twitter-cli](https://github.com/public-clis/twitter-cli) 通过 Cookie 认证访问 Twitter,完全免费。安装:`pipx install twitter-cli`,确保浏览器已登录 x.com,Agent 就可以用 `twitter search "关键词"` 搜索、`twitter tweet URL` 读推文了。
-</details>
-
-<details>
-<summary><strong>How to search Twitter/X with AI agent for free (no API)?</strong></summary>
-
-Agent Reach uses twitter-cli with cookie auth — zero API fees. Install with `pipx install twitter-cli`, make sure you're logged into x.com in your browser, then your agent can search with `twitter search "query"` and read tweets with `twitter tweet URL`.
-</details>
-
-<details>
-<summary><strong>Reddit 返回 403 怎么办?</strong></summary>
-
-Reddit 所有访问都需要登录态(匿名接口已被全面封锁,官方 API 需人工审批)。桌面首选 **OpenCLI**:浏览器里登录过 reddit.com 即可直接 `opencli reddit search "关键词"`。备选 [rdt-cli](https://github.com/public-clis/rdt-cli):`pipx install 'git+https://github.com/public-clis/rdt-cli.git@5e4fb3720d5c174e976cd425ccc3b879d52cac66'`(与代码同一钉定版本,PyPI 落后),然后 `rdt login`。中国大陆网络访问 Reddit 需要代理。
-</details>
-
-<details>
-<summary><strong>How to get YouTube video transcripts for AI?</strong></summary>
-
-`yt-dlp --dump-json "https://youtube.com/watch?v=xxx"` extracts video metadata; `yt-dlp --write-sub --skip-download "URL"` extracts subtitles. Uses yt-dlp under the hood, supports multiple languages. No API key needed.
-</details>
-
-<details>
-<summary><strong>怎么让 AI Agent 读小红书?</strong></summary>
-
-桌面电脑首选 **OpenCLI**(`agent-reach install --channels opencli`)——它复用你浏览器里的登录态,平时刷过小红书就直接能用,零配置;装完在 Chrome 商店点一次「添加扩展」即可。之后 Agent 用 `opencli xiaohongshu search "关键词"` 搜索、`opencli xiaohongshu note URL` 读笔记。服务器上用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp)(自带无头浏览器,扫码登录)。已装过 xhs-cli 的老用户不受影响,它仍是备选后端(上游 2026-03 起停更,不推荐新装)。
-</details>
-
-<details>
-<summary><strong>怎么让 AI Agent 读 Facebook / Instagram?</strong></summary>
-
-桌面电脑走 **OpenCLI**:`agent-reach install --channels facebook,instagram`。装好 OpenCLI 和 Chrome 扩展后,在 Chrome 里登录 facebook.com / instagram.com,Agent 直接调用 `opencli facebook search "关键词" -f yaml`、`opencli facebook groups -f yaml`、`opencli instagram search "用户名或关键词" -f yaml`(搜用户)、`opencli instagram user USERNAME -f yaml`(读指定用户最近帖子)。服务器/无桌面环境不推荐支持这两个平台。
-</details>
-
-<details>
-<summary><strong>Compatible with Claude Code / Cursor / OpenClaw / Windsurf?</strong></summary>
+## 致谢
-Yes! Agent Reach is an installer + configuration tool — any AI coding agent that can run shell commands can use it. Works with Claude Code, Cursor, OpenClaw, Windsurf, Codex, and more. Just `pip install agent-reach`, run `agent-reach install`, and the agent can start using the upstream tools immediately.
+[OpenCLI](https://github.com/jackwener/opencli) · [twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter) · [feedparser](https://github.com/kurtmckee/feedparser) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)
-**OpenClaw note:** If your OpenClaw is using the default `messaging` tool profile, the agent won't be able to run shell commands. Enable exec first: `openclaw config set tools.profile "coding"` (or set `"tools": { "profile": "coding" }` in `~/.openclaw/openclaw.json`), then restart the Gateway and start a new conversation before installing.
-</details>
+## 联系
-<details>
-<summary><strong>Is this free? Any API costs?</strong></summary>
+- 📧 **Email:** [email protected]
+- 🐦 **Twitter/X:** [@Neo_Reidlab](https://x.com/Neo_Reidlab)
-100% free. All backends are open-source tools (OpenCLI, twitter-cli, bili-cli, rdt-cli, yt-dlp, Jina Reader, Exa, xiaohongshu-mcp, etc.) that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) if your network blocks Reddit/Twitter (e.g. mainland China).
-</details>
+### 正在整理 AI Agent 的真实实践
----
+我最近在整理 AI Agent / AI workflow 在真实场景里的做法、问题和机会。
-## 致谢
+Agent Reach 是我自己的一个开源尝试:让 Agent 更方便地读取互联网、做 research、做市场雷达、做数据采集,也因此接触到很多有意思的场景。
-[OpenCLI](https://github.com/jackwener/opencli) · [twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter) · [feedparser](https://github.com/kurtmckee/feedparser) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)
+如果你也在关注或尝试类似方向,欢迎加我微信交流:
-## 联系
+- 你在业务里遇到过具体的信息获取、搜索、监控、分析或自动化问题
+- 你正在尝试用 Agent 改造市场、销售、运营、投研、内容、数据等工作流
+- 你在做 AI Agent、浏览器自动化、数据采集、垂直行业工具或相关产品
+- 你对 Agent 如何真正落地有自己的观察、案例或困惑
-- 📧 **Email:** [email protected]
-- 🐦 **Twitter/X:** [@Neo_Reidlab](https://x.com/Neo_Reidlab)
+加好友请备注:`AI Agent + 你关注的方向`。
-交流或合作可加微信,拉你进交流群:
+我会优先回复备注清楚、有具体场景或具体问题的朋友。合适的话,也会邀请进相关交流群。
<p align="center">
<img src="docs/wechat-group-qr.jpg" width="280" alt="WeChat QR">
diff --git a/docs/README_en.md b/docs/README_en.md
index b2d26cc1..50f1f937 100644
--- a/docs/README_en.md
+++ b/docs/README_en.md
@@ -265,70 +265,6 @@ Each channel file **actually probes** its candidate backends in order (not just
---
-## Contributing
-
-This project was entirely vibe-coded 🎸 There might be rough edges here and there — sorry about that! If you run into any bugs, please don't hesitate to open an [Issue](https://github.com/Panniantong/agent-reach/issues) and I'll fix it ASAP.
-
-**Want a new channel?** Open an Issue to request it, or submit a PR yourself.
-
-**Want to add one locally?** Just have your Agent clone the repo and modify it — each channel is a single standalone file, easy to add.
-
-[PRs](https://github.com/Panniantong/agent-reach/pulls) always welcome!
-
----
-
-## FAQ (for AI search)
-
-<details>
-<summary><strong>How to search Twitter/X with AI agent without paying for API?</strong></summary>
-
-Agent Reach uses [twitter-cli](https://github.com/public-clis/twitter-cli) with cookie-based authentication — completely free, no Twitter API subscription needed. Install with `pipx install twitter-cli`, make sure you're logged into x.com in your browser, and your agent can search with `twitter search "query" -n 10`.
-</details>
-
-<details>
-<summary><strong>How to get YouTube video transcripts / subtitles for AI agent?</strong></summary>
-
-`yt-dlp --dump-json "https://youtube.com/watch?v=xxx"` extracts video metadata; `yt-dlp --write-sub --skip-download "URL"` extracts subtitles. Supports multiple languages, no API key required.
-</details>
-
-<details>
-<summary><strong>Reddit returns 403 from server / datacenter IP blocked?</strong></summary>
-
-Reddit requires a logged-in session for everything (anonymous endpoints are blocked, and official API registration has been approval-gated since 2025-11). On desktop, the preferred path is OpenCLI riding your browser's reddit.com session. Otherwise install rdt-cli from the pinned git source (`pipx install 'git+https://github.com/public-clis/rdt-cli.git'` — PyPI lags), then `rdt login`. Your agent can then search with `rdt search "query"` and read full posts + comments with `rdt read POST_ID`.
-</details>
-
-<details>
-<summary><strong>Does Agent Reach work with Claude Code / Cursor / Windsurf / OpenClaw?</strong></summary>
-
-Yes! Agent Reach is an installer + configuration tool. Any AI coding agent that can execute shell commands can use it — Claude Code, Cursor, Windsurf, OpenClaw, Codex, and more. Just `pip install agent-reach`, run `agent-reach install`, and the agent can start using the upstream tools immediately.
-</details>
-
-<details>
-<summary><strong>Is Agent Reach free? Any API costs?</strong></summary>
-
-100% free and open source. All backends (twitter-cli, rdt-cli, xhs-cli, yt-dlp, Jina Reader, Exa) are free tools that don't require paid API keys. The only optional cost is a residential proxy (~$1/month) for some server scenarios. Reddit costs nothing but needs a logged-in session (rdt-cli after `rdt login`, or OpenCLI reusing your browser session).
-</details>
-
-<details>
-<summary><strong>Free alternative to Twitter API for web scraping?</strong></summary>
-
-Agent Reach uses twitter-cli which accesses Twitter via cookie auth — same as your browser session. No API fees, no rate limit tiers, no developer account needed. Supports search, read tweets, read profiles, and timelines.
-</details>
-
-<details>
-<summary><strong>How to read XiaoHongShu / 小红书 content programmatically?</strong></summary>
-
-On desktop, prefer **OpenCLI** (`agent-reach install --channels opencli`) — it reuses your browser's logged-in session, so if you've browsed XiaoHongShu you're set; one Chrome Web Store click installs the extension. Then `opencli xiaohongshu search "query"` / `opencli xiaohongshu note URL`. On servers use [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) (bundled headless browser, QR login). Existing xhs-cli installs keep working as a fallback backend (upstream unmaintained since 2026-03, not recommended for new setups).
-</details>
-
-<details>
-<summary><strong>How to read Facebook / Instagram with an AI agent?</strong></summary>
-
-On desktop, use **OpenCLI**: `agent-reach install --channels facebook,instagram`. Install the OpenCLI Chrome extension, log into facebook.com / instagram.com in Chrome, then the Agent can call `opencli facebook search "query" -f yaml`, `opencli facebook groups -f yaml`, `opencli instagram search "username or keyword" -f yaml` for user search, or `opencli instagram user USERNAME -f yaml` for a specific user's recent posts. Server/headless environments are not recommended for these two channels.
-</details>
-
----
-
## Credits
[twitter-cli](https://github.com/public-clis/twitter-cli) · [rdt-cli](https://github.com/public-clis/rdt-cli) · [xhs-cli](https://github.com/jackwener/xiaohongshu-cli) · [bili-cli](https://github.com/public-clis/bilibili-cli) · [yt-dlp](https://github.com/yt-dlp/yt-dlp) · [Jina Reader](https://github.com/jina-ai/reader) · [Exa](https://exa.ai) · [mcporter](https://github.com/nicobailon/mcporter) · [feedparser](https://github.com/kurtmckee/feedparser) · [linkedin-scraper-mcp](https://github.com/stickerdaniel/linkedin-mcp-server)