Track bundled vendor runtime sources

vendor/Agent-Reach/agent_reach/guides/setup-exa.md

@@ -0,0 +1,41 @@
+# Exa Search 配置指南
+
+## 功能说明
+Exa 是一个 AI 语义搜索引擎。通过 MCP 接入，**免费、无需 API Key**。配置后解锁：
+- 全网语义搜索
+- Reddit 搜索（通过 site:reddit.com）
+- Twitter 搜索（通过 site:x.com）
+
+## Agent 可自动完成的步骤
+
+`agent-reach install --env=auto` 会自动完成以下步骤，通常不需要手动操作。
+
+### 1. 安装 mcporter
+```bash
+npm install -g mcporter
+```
+
+### 2. 注册 Exa MCP
+```bash
+mcporter config add exa https://mcp.exa.ai/mcp
+```
+
+### 3. 验证
+```bash
+agent-reach doctor | grep "Search"
+mcporter call 'exa.web_search_exa(query: "test", numResults: 1)'
+```
+
+## 需要用户手动做的步骤
+
+**无。** Exa 通过 MCP 接入，免费、无需注册、无需 API Key。
+
+如果 `agent-reach install` 因为网络问题没有自动配置 Exa，手动运行上面两条命令即可。
+
+## 常见问题
+
+**Q: 有搜索次数限制吗？**
+A: MCP 端点由 Exa 官方提供（mcp.exa.ai），当前免费无限制。如果未来有变化，会在 agent-reach 更新中适配。
+
+**Q: mcporter 是什么？**
+A: MCP 协议的命令行桥接工具，用来调用 MCP Server。Agent Reach 用它来连接 Exa 和小红书。

vendor/Agent-Reach/agent_reach/guides/setup-groq.md

@@ -0,0 +1,47 @@
+# Groq Whisper 配置指南
+
+## 功能说明
+当 YouTube/Bilibili 视频没有字幕时，用 Groq 的 Whisper API 进行语音转文字。Groq 提供免费额度。
+
+## Agent 可自动完成的步骤
+
+1. 检查是否已配置：
+```bash
+agent-reach doctor | grep -i "groq\|whisper"
+```
+
+2. 如果用户提供了 key，写入配置：
+```python
+from agent_reach.config import Config
+c = Config()
+c.set("groq_api_key", "用户提供的KEY")
+```
+
+3. 测试（可选）：
+```bash
+curl -s https://api.groq.com/openai/v1/models \
+  -H "Authorization: Bearer 用户提供的KEY" \
+  -o /dev/null -w "%{http_code}"
+```
+返回 200 = 可用
+
+## 需要用户手动做的步骤
+
+请告诉用户：
+
+> 视频语音转文字需要一个 Groq API Key（免费）。
+>
+> 步骤：
+> 1. 打开 https://console.groq.com
+> 2. 用 Google 账号或邮箱注册
+> 3. 点击左侧 "API Keys"
+> 4. 点击 "Create API Key"
+> 5. 复制生成的 Key，发给我
+>
+> Groq 提供免费额度，日常使用完全够用。
+
+## Agent 收到 key 后的操作
+
+1. 写入配置：`config.set("groq_api_key", key)`
+2. 测试 API 可用性
+3. 反馈："✅ 语音转文字已开启！现在遇到没有字幕的视频，我也能帮你提取内容了。"

vendor/Agent-Reach/agent_reach/guides/setup-reddit.md

@@ -0,0 +1,54 @@
+# Reddit 配置指南
+
+## 功能说明
+
+Reddit 封锁了几乎所有非浏览器的直接访问（包括数据中心和 ISP 代理 IP），JSON API 返回 403。
+
+Agent Reach 通过 **rdt-cli** 实现 Reddit 的搜索和阅读功能：
+- **搜索**：`rdt search "关键词"`
+- **阅读完整帖子+评论**：`rdt read POST_ID`
+
+免费，无需代理，无需 API Key。需要登录认证（`rdt login`，自动从浏览器提取 Cookie）。
+
+## Agent 可自动完成的步骤
+
+1. 检查 rdt-cli 是否可用：
+```bash
+which rdt && echo "installed" || echo "not installed"
+```
+
+2. 如果未安装，自动安装（PyPI 版本暂时落后，从 GitHub 安装最新版）：
+```bash
+pipx install 'git+https://github.com/public-clis/rdt-cli.git'
+```
+
+或一键安装：
+```bash
+agent-reach install --env=auto --channels=reddit
+```
+
+## 使用示例
+
+搜索 Reddit 内容：
+```bash
+rdt search "python best practices" -n 5
+```
+
+阅读完整帖子和评论：
+```bash
+rdt read POST_ID
+```
+
+## 需要用户手动做的步骤
+
+无。rdt-cli 通过 `agent-reach install --env=auto` 自动安装。
+
+## Fallback：Exa 搜索
+
+如果你已经配置了 Exa（通过 mcporter），也可以通过 Exa 搜索 Reddit 内容：
+
+```bash
+mcporter call 'exa.web_search_exa(query: "python best practices", numResults: 5, includeDomains: ["reddit.com"])'
+```
+
+rdt-cli 是当前推荐方案，无需额外配置即可使用。

vendor/Agent-Reach/agent_reach/guides/setup-twitter.md

@@ -0,0 +1,84 @@
+# Twitter 高级功能配置指南（twitter-cli）
+
+Twitter 基础阅读通过 Jina Reader 免费可用，无需配置。
+
+高级功能需要 twitter-cli（@public-clis/twitter-cli）：
+
+- 搜索推文（`twitter search`）
+- 读取完整推文和对话链（`twitter tweet`、`twitter thread`）
+- 用户时间线（`twitter timeline`）
+- 长文阅读（`twitter article`）
+
+twitter-cli 是免费开源工具（pipx 安装），但需要你的 Twitter 账号 cookie。
+
+## 快速配置
+
+1. 检查 twitter-cli 是否安装：
+
+```bash
+which twitter && echo "installed" || echo "not installed"
+```
+
+2. 安装 twitter-cli：
+
+```bash
+pipx install twitter-cli
+```
+
+3. 测试是否配置好：
+
+```bash
+twitter search "test" -n 1
+```
+
+## 获取 Cookie（Cookie-Editor 方式，推荐）
+
+1. 安装 [Cookie-Editor](https://cookie-editor.com/) 浏览器扩展
+2. 登录 x.com
+3. 点击 Cookie-Editor 图标 → Export → 复制全部
+4. 运行配置命令：
+
+```bash
+agent-reach configure twitter-cookies "粘贴的 cookie JSON"
+```
+
+这会自动提取 `auth_token` 和 `ct0`，并写入环境变量。
+
+## 手动设置 Cookie
+
+如果你已经知道 `auth_token` 和 `ct0`：
+
+1. 安装 twitter-cli（如果没装）：`pipx install twitter-cli`
+
+2. 设置环境变量：
+
+```bash
+export AUTH_TOKEN="你的auth_token"
+export CT0="你的ct0"
+```
+
+3. 测试：
+
+```bash
+twitter search "test" -n 1
+```
+
+## 代理配置
+
+> twitter-cli 支持通过环境变量设置代理：
+
+```bash
+export HTTP_PROXY="http://user:pass@host:port"
+export HTTPS_PROXY="http://user:pass@host:port"
+twitter search "test" -n 1
+```
+
+也可以使用全局代理工具：
+
+```bash
+proxychains twitter search "test" -n 1
+```
+
+## Fallback：bird CLI
+
+如果你已经安装了 [bird CLI](https://www.npmjs.com/package/@steipete/bird)（`npm install -g @steipete/bird`），它也能正常工作。Agent Reach 会自动检测并使用已安装的 bird。两者功能类似，twitter-cli 是当前推荐方案。

vendor/Agent-Reach/agent_reach/guides/setup-xiaohongshu.md

@@ -0,0 +1,85 @@
+# 小红书配置指南
+
+## 功能说明
+读取和搜索小红书笔记。通过 [xhs-cli](https://github.com/jackwener/xiaohongshu-cli)（⭐1.5K，pipx 一行安装）实现。
+
+## 前置条件
+- Python 3.10+（pipx 安装）
+- 浏览器已登录 xiaohongshu.com（用于导出 Cookie）
+
+## Agent 可自动完成的步骤
+
+### 1. 安装 xhs-cli
+```bash
+pipx install xiaohongshu-cli
+```
+
+### 2. 登录（从浏览器提取 Cookie）
+```bash
+xhs login
+```
+
+> 这会自动从浏览器提取 Cookie。如果自动提取失败，可以手动导入（见下方）。
+
+### 3. 验证
+```bash
+agent-reach doctor
+```
+
+应该看到小红书显示为 ✅。
+
+## 需要用户手动做的步骤
+
+如果 `xhs login` 自动提取失败，需要手动导入 cookies：
+
+> **推荐方式：Cookie-Editor 浏览器导出（最可靠）**
+>
+> 1. 在 Chrome 中安装 [Cookie-Editor](https://chromewebstore.google.com/detail/cookie-editor/hlkenndednhfkekhgcdicdfddnkalmdm) 扩展
+> 2. 浏览器登录 xiaohongshu.com
+> 3. 点击 Cookie-Editor 图标 → Export → Header String
+> 4. 把导出的字符串发给 Agent，运行：`agent-reach configure xhs-cookies "导出的cookie字符串"`
+>
+> **注意**：不要依赖 QR 扫码登录，Cookie-Editor 导出方式最简单可靠。
+
+## 使用示例
+
+搜索笔记：
+```bash
+xhs search "关键词"
+```
+
+阅读笔记详情：
+```bash
+xhs read NOTE_ID
+```
+
+查看评论：
+```bash
+xhs comments NOTE_ID
+```
+
+## 常见问题
+
+**Q: Cookie 过期了？**
+A: 重新运行 `xhs login` 或通过 Cookie-Editor 重新导出。
+
+**Q: 小红书提示 IP 风险？**
+A: 推荐使用住宅代理：`export HTTP_PROXY="http://user:pass@ip:port"`。
+
+**Q: xhs-cli 不支持我的系统？**
+A: 确保 Python 3.10+ 和 pipx 已安装。运行 `pipx install xiaohongshu-cli` 即可。
+
+## 备选方案：Docker MCP
+
+如果你已经在使用 [xiaohongshu-mcp](https://github.com/xpzouying/xiaohongshu-mcp) Docker 方案，它也能正常工作：
+
+```bash
+docker run -d \
+  --name xiaohongshu-mcp \
+  -p 18060:18060 \
+  xpzouying/xiaohongshu-mcp
+
+mcporter config add xiaohongshu http://localhost:18060/mcp
+```
+
+xhs-cli 是当前推荐方案，不需要 Docker，安装更简单。