Pnant
4bc860c74d
Merge pull request #45 from Panniantong/fix/xiaohongshu-arm64-support
...
fix: ARM64/Apple Silicon support for xiaohongshu-mcp Docker setup
2026-02-27 15:21:21 +08:00
Panniantong
d4e437bf2c
fix: add ARM64/Apple Silicon support for xiaohongshu-mcp Docker setup
...
- Detect ARM64 architecture and auto-add --platform linux/amd64 to
docker run hints in doctor/check output
- Add ARM64 FAQ section to setup guide with two options:
Rosetta emulation (--platform linux/amd64) or build from source
- Closes #44
2026-02-27 08:06:06 +01:00
Pnant
dbcc668f47
Merge pull request #40 from peter941221/fix/security-hardening-split-v2
...
fix: split security hardening and setup mcporter config checks
2026-02-27 13:30:52 +08:00
Pnant
40f833d0d1
Merge pull request #41 from peter941221/chore/quality-infra-split-v3
...
chore: split quality infrastructure into focused PR
2026-02-27 13:26:49 +08:00
Pnant
dc4d7cd7a5
Merge pull request #24 from Daiyimo/main
...
feat: add uninstall command; fix utf-8 encoding and minor cleanups
2026-02-27 13:24:21 +08:00
Pnant
60f5ddf4f0
Merge pull request #35 from Panniantong/fix/mcporter-list-hang
...
fix: replace 'mcporter list' with 'mcporter config list' to prevent hangs
2026-02-27 12:56:40 +08:00
Panniantong
39f76ee4dc
fix: replace 'mcporter list' with 'mcporter config list' to prevent hangs
...
mcporter list probes all configured servers sequentially, which can hang
indefinitely when servers are slow/offline. mcporter config list reads
config without probing — sufficient for checking if a server is configured.
Affected: doctor checks (4 channels) and install command (2 calls).
Fixes #34
2026-02-27 03:06:27 +01:00
Pnant
a5682716ec
Merge pull request #31 from Panniantong/docs/cookie-ban-warning
...
docs: 添加 Cookie 登录封号风险提醒
2026-02-26 22:41:53 +08:00
Panniantong
f269667a34
docs: 添加 Cookie 登录封号风险提醒,强调使用小号
...
- README: Cookie 安全建议新增封号风险说明
- install.md: Security tip 补充 account ban 风险
- SKILL.md: Cookie 导入段落加封号提醒
2026-02-26 15:13:25 +01:00
Pnant
090b01c909
Merge pull request #30 from Panniantong/fix/sync-version-string
...
fix: sync __version__ with pyproject.toml (1.0.0 → 1.2.0)
2026-02-26 22:08:35 +08:00
Panniantong
58b3a4dcb3
fix: sync __version__ with pyproject.toml (1.0.0 → 1.2.0)
...
Fixes #29 — __version__ in __init__.py was still '1.0.0' while pyproject.toml
had already been bumped to '1.2.0'. This caused misleading output in
'agent-reach --version' and 'agent-reach doctor'.
2026-02-26 15:07:24 +01:00
Panniantong
37b4cdeddc
bump: v1.2.0
2026-02-26 13:34:41 +01:00
Pnant
bf6dc7084b
Merge pull request #28 from Panniantong/feat/douyin-channel
...
feat: 新增抖音(Douyin)渠道
2026-02-26 20:34:17 +08:00
Panniantong
50f2181fcc
feat: 新增抖音(Douyin)渠道 - 基于 douyin-mcp-server
...
- 新增 agent_reach/channels/douyin.py
- 更新 doctor 检测逻辑
- 更新 install.md/SKILL.md/README 文档
- 通过 mcporter 调用 douyin-mcp-server
- 支持视频解析、下载链接获取
- 无需登录即可使用
2026-02-26 13:25:57 +01:00
Pnant
b387a67b51
Merge pull request #27 from Panniantong/docs/cookie-editor-first
...
docs: Cookie-Editor 作为所有 cookie 平台的首选登录方式
2026-02-26 19:17:35 +08:00
Panniantong
a96c5cda14
docs: Cookie-Editor 作为首选登录方式,统一所有 cookie 平台
...
- install.md: 新增通用 Cookie 导入说明,所有平台统一流程
- install.md: 小红书登录方式改为 Cookie-Editor 优先,扫码降级为备选
- SKILL.md: Cookie 导入独立成段,明确优先级
- README.md: 更新 Cookie 说明,强调 Cookie-Editor 比扫码更简单可靠
2026-02-26 12:16:34 +01:00
Pnant
cf70302e92
Merge pull request #23 from Panniantong/refactor/simplify-to-installer
...
refactor: 回归安装器+文档定位,砍掉 read/search 包装层
2026-02-26 15:29:44 +08:00
Panniantong
80a08c8c10
docs: update all remaining references to use upstream tools directly
...
- docs/README_en.md: update FAQ, Works Out of the Box, Design Philosophy
- docs/troubleshooting.md: Exa fallback uses mcporter directly
- agent_reach/guides/setup-exa.md: test with mcporter call
- agent_reach/guides/setup-wechat.md: test with Jina Reader
2026-02-26 08:25:06 +01:00
Panniantong
606e8900ce
docs: update install.md — remove read/search references, add upstream tools table
2026-02-26 08:20:20 +01:00
Panniantong
a37e9aa190
refactor: strip to installer + doctor + docs, remove read/search wrapper layer
...
BREAKING CHANGE: Remove all `agent-reach read` and `agent-reach search-*` commands.
Agent Reach is now an installer, configuration tool, and doctor —
not a wrapper layer. After installation, agents call upstream tools
directly (bird CLI, yt-dlp, mcporter, gh CLI, Jina Reader, etc.).
What's kept:
- agent-reach install: one-shot installer
- agent-reach doctor: channel status overview
- agent-reach configure: cookies, proxy, credentials
- agent-reach setup: interactive wizard
- SKILL.md: complete guide for agents to use upstream tools directly
What's removed:
- agent-reach read URL (and all channel read() methods)
- agent-reach search-* commands (and all channel search() methods)
- ReadResult / SearchResult data classes
- URL routing system (get_channel_for_url)
- All parsing/conversion logic (VTT, Reddit JSON, bird text parser, etc.)
- MCP server read/search tools (kept only get_status)
Net change: -1790 lines. Less code = fewer bugs.
2026-02-26 08:15:56 +01:00
Pnant and Panniantong
1cbf6a7b9c
fix(xiaohongshu): 修复 xsec_token 丢失导致无法读取笔记详情 ( #17 )
...
问题:搜索结果包含 xsecToken 但被丢弃,read() 只从首页 feed
查找 token,几乎不可能匹配到目标笔记。
修复:
1. search() 返回的 URL 携带 xsec_token 查询参数
2. read() 三级 token 查找:URL 参数 → 首页 feed → 搜索反查
3. 全部失败时回退到 Jina Reader
Fixes #15
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-02-26 14:36:36 +08:00
Pnant
68319ec683
Merge pull request #16 from Panniantong/remove/instagram
...
remove(instagram): 移除 Instagram 渠道(上游反爬封杀)
2026-02-26 14:23:26 +08:00
Panniantong
f70711e75e
remove(instagram): 移除 Instagram 渠道
...
Instagram 反爬封杀导致所有开源工具(instaloader 等)失效,
无论有无 cookies 都无法正常使用。
- 删除 instagram.py 渠道文件
- 移除 CLI 中 search-instagram、configure instagram-cookies 等命令
- 移除 setup/doctor 中 instaloader 依赖检查
- 更新 README、docs、SKILL.md、pyproject.toml
上游 issue: instaloader#2585, instaloader#2648
Relates to: #13
2026-02-26 07:20:13 +01:00
Panniantong
c3a9813b1c
seo: GitHub SEO + GEO 优化,提升项目可发现性
...
1. 新增 llms.txt — 让 AI 搜索引擎(ChatGPT/Claude/Perplexity)理解项目
2. README 中英文加 FAQ 区块 — AI 搜索友好的常见问题解答
3. pyproject.toml keywords 扩展到 21 个 — 覆盖更多搜索词
2026-02-25 22:32:22 +01:00
Panniantong
d291d27664
docs: install.md 和 SKILL.md 补充 Twitter 代理方案说明
...
让 Agent 在配置 Twitter 时知道:
- undici 需要安装(npm install -g undici)
- 代理注入是自动的,不需要用户额外操作
- fetch failed 的排查步骤
2026-02-25 21:45:40 +01:00
Pnant
0be4f097d0
Merge pull request #10 from Panniantong/fix/twitter-fetch-failed
...
fix: Twitter bird CLI fetch failed — 自动 fallback + 连通性检测
2026-02-26 04:44:39 +08:00
Panniantong
12bd727e30
fix: Twitter bird CLI fetch failed — 自动代理注入 + 连通性检测 + Exa fallback
...
问题:bird CLI 用 Node.js 原生 fetch(),不走 HTTP_PROXY,
导致需要代理的用户(如 Windows + 本地代理)完全无法使用。
修复:
1. 自动代理注入:检测到 HTTP_PROXY/HTTPS_PROXY 时,通过 undici 的
EnvHttpProxyAgent 让 Node.js fetch 自动走代理,用户无需任何额外配置
2. doctor 检测:实际跑 bird whoami 测连通性,失败时给出具体原因
3. search fallback:bird 搜索失败时自动 fallback 到 Exa
4. install:自动安装 undici(npm install -g undici)
5. 新增 troubleshooting.md:常见问题解决方案
Fixes #9
2026-02-25 21:35:21 +01:00
Panniantong
b6d135c977
docs: 小红书配置方式统一为「告诉 Agent 帮我配」
2026-02-25 16:03:50 +01:00
Pnant
291d073223
Merge pull request #8 from Panniantong/refactor/skill-consolidate
...
refactor: 合并 SKILL.md 为单一来源,更新为 12 渠道
2026-02-25 22:32:31 +08:00
Pnant
ef0889dd69
Merge pull request #7 from Panniantong/docs/channel-limitations
...
docs: 补充新渠道使用限制说明
2026-02-25 22:32:27 +08:00
Panniantong
545a6c5761
docs: 新渠道配置方式统一为「告诉 Agent 帮我配」
...
跟其他渠道风格一致,不单独列限制说明。
具体配置步骤都在 install.md 里,Agent 会自动引导。
2026-02-25 15:27:51 +01:00
Panniantong
00f3edd9cc
refactor: 合并 SKILL.md 为单一来源,更新为 12 个渠道
...
- 删除 agent-reach/SKILL.md(重复)
- 删除 agent_reach/integrations/skill/SKILL.md(重复)
- 保留并更新 agent_reach/skill/SKILL.md 为唯一来源
- 新增 Instagram/LinkedIn/Boss直聘 搜索命令
- 新增渠道配置引导流程说明
- 描述从 9+ 更新为 12+
2026-02-25 15:11:51 +01:00
Panniantong
2f674f1e45
security: doctor warns if config.yaml permissions are too open
...
Adds a check in 'agent-reach doctor' that warns when ~/.agent-reach/config.yaml
is readable by other users (group/world). Suggests chmod 600 to fix.
Ref: #6
2026-02-25 14:16:08 +01:00
Panniantong
c642e18e1f
release: v1.1.0 — 新增 Instagram、LinkedIn、Boss直聘 三个渠道
...
🆕 新渠道:
- 📷 Instagram — instaloader 读取帖子和 Profile
- 💼 LinkedIn — linkedin-scraper-mcp 读取 Profile、公司、职位
- 🏢 Boss直聘 — mcp-bosszp 搜索职位、向 HR 打招呼
📈 改进:
- 渠道数量 9 → 12
- 新增 CHANGELOG.md
- CLI 新增 search-instagram / search-linkedin / search-bosszhipin
- 安装指南更新
- 致谢列表更新
2026-02-25 14:14:30 +01:00
Panniantong
31eb6db537
fix: use encoding='utf-8' with errors='replace' for bird subprocess calls
...
Fixes non-UTF-8 character handling in Twitter content.
Replaces text=True with explicit encoding parameters.
Co-authored-by: dev-starlight <dev-starlight@users.noreply.github.com >
Closes #3
2026-02-25 13:44:47 +01:00
Panniantong
fe7ed1656b
merge: 解决与 main 分支的冲突
2026-02-25 13:16:45 +01:00
Panniantong
5906d4ee3f
fix: LinkedIn MCP 参数适配 — 用 company_name/linkedin_username 替代 url
...
linkedin-scraper-mcp 的 API 参数是 company_name 和 linkedin_username,
不是 url。从 URL 中提取 slug 传给 MCP。
timeout 增加到 60 秒(浏览器自动化需要时间)。
search 去掉不支持的 limit 参数。
2026-02-25 13:16:00 +01:00
Panniantong
823f239a54
docs: 完善三个新渠道的登录说明
...
- Instagram: Cookie-Editor 导入(推荐)或 instaloader --login
- LinkedIn: linkedin-scraper-mcp --login(服务器需 VNC 远程桌面)
- Boss直聘: 启动 MCP 后 App 扫码
README 平台表格更新登录方式说明
2026-02-25 11:49:51 +01:00
Panniantong
e8fe33c80c
feat: Instagram 支持 Cookie-Editor 导入 + 超时 fallback 优化
...
- agent-reach configure instagram-cookies 支持 Cookie-Editor Header String
- Instagram cookie 保存到 ~/.agent-reach/instagram-cookies.txt
- instaloader 429 限速时 15 秒自动超时 fallback 到 Jina Reader
- LinkedIn/Boss直聘 保持使用各自 MCP 的原生登录流程(不侵入)
- doctor 提示信息更新
2026-02-25 11:13:52 +01:00
Pnant
284479eec9
Merge pull request #4 from Panniantong/docs/server-cookie-login
2026-02-25 17:59:04 +08:00
Panniantong
aafd6839e9
fix: Instagram 429 限速时 15 秒超时后自动 fallback 到 Jina
...
instaloader 遇到 429 会自动等 30 分钟重试导致卡住。
改为在 executor 里跑,15 秒超时后自动切 Jina Reader fallback。
2026-02-25 10:32:51 +01:00
Panniantong
e3804108fe
feat: 新增 Instagram、LinkedIn、Boss直聘 三个渠道
...
新增渠道:
- Instagram: 基于 instaloader (⭐ 9.8K),读取帖子/Profile,Cookie 登录
- LinkedIn: 基于 linkedin-scraper-mcp (⭐ 900+) MCP 服务,Jina Reader fallback
- Boss直聘: 基于 mcp-bosszp MCP 服务,Jina Reader fallback
代码改动:
- 新建 channels/instagram.py, linkedin.py, bosszhipin.py
- 注册到 channels/__init__.py
- cli.py 添加 search-instagram/linkedin/bosszhipin 子命令
- cli.py 安装逻辑添加 instaloader 自动安装
- core.py 添加 search_instagram/linkedin/bosszhipin 方法
- README.md + docs/README_en.md 更新平台表格和选型表格
- docs/install.md 添加三个新渠道的配置说明和 Quick Reference
2026-02-25 10:25:30 +01:00
Panniantong
cc9c90c228
docs: 补充服务器用户小红书登录方式说明
...
服务器(无 UI 界面)用户无法直接扫码登录小红书,补充说明最方便的方式:
在自己电脑登录后用 Cookie-Editor 导出 Cookie 发给 Agent 配置。
- install.md: 小红书登录方式分本地/服务器两种场景说明
- README.md: Cookie 提示补充服务器用户指引
2026-02-25 09:54:18 +01:00
Panniantong
c0a0518c01
fix: 修复 README 中 2 个 404 链接
...
- bird: github.com/steipete/bird (已删除) → npmjs.com/package/@steipete/bird
- mcporter: github.com/nicepkg/mcporter (404) → github.com/steipete/mcporter (正确地址)
- 致谢增加 mcporter 和 xiaohongshu-mcp
2026-02-25 05:19:25 +01:00
Panniantong
008811bf87
docs: 简化安装入口,只保留一种方式 + 展开说明背后做了什么
...
- 去掉手动安装和 Skill 安装的独立入口
- 只保留'复制一句话给 Agent'
- 用 details 展开解释安装过程(CLI → 依赖 → 搜索引擎 → Skill 注册)
2026-02-25 05:15:34 +01:00
Panniantong
a0ecd438ee
fix: 完善所有渠道安装指引,修复文档错误
...
- 小红书: 添加 Docker 安装命令 (xpzouying/xiaohongshu-mcp),替换模糊的 'install xiaohongshu-mcp'
- Exa: 修正文档错误(实际免费无需 API Key,之前写要 Key)
- CLI: install 命令输出添加小红书 Docker 安装指引
- channel: xiaohongshu.py 所有错误信息添加完整安装步骤
- install.md: 添加小红书配置段落
- README: 修正小红书 GitHub 链接,Exa 描述改为免费无需 Key
Fixes user-reported issue: 安装后不知道怎么装小红书 MCP
2026-02-25 05:10:56 +01:00
Panniantong
868822e2ed
fix: Skill 加 Setup 引导,纯 Skill 安装也能自动触发 pip install
...
SKILL.md 增加 Setup 段:Agent 读到 skill 后先检测 agent-reach CLI
是否存在,不存在则自动 pip install + agent-reach install。
README 说明同步更新。
2026-02-25 04:35:35 +01:00
Panniantong
25d869d3fe
feat: Agent Reach 作为 Skill 安装
...
- 新增 agent-reach/SKILL.md — skills.sh 兼容格式
安装: npx skills add Panniantong/Agent-Reach@agent-reach
- agent-reach install 自动检测 OpenClaw / Claude Code / 通用 Agent
并在对应 skill 目录注册 SKILL.md
- SKILL.md 打包进 pip 包(agent_reach/skill/SKILL.md)
- README 中英文都加了 Skill 安装方式
2026-02-25 04:24:16 +01:00
Panniantong
93ad9c5722
fix: birdx → bird CLI (npm @steipete/bird)
...
birdx 从来不是 PyPI 包,pip install birdx 必然失败。
实际工具是 npm 包 @steipete/bird,一个 Twitter GraphQL CLI。
变更:
- 安装器改用 npm install -g @steipete/bird
- twitter.py 直接调 bird,通过环境变量传 AUTH_TOKEN/CT0
- 兼容已有的 birdx wrapper(shutil.which 回退)
- 更新所有文档引用
- 重写 setup-twitter.md 指南
2026-02-25 04:02:42 +01:00
Panniantong
17970b2789
feat: 添加 watch 和 check-update 命令 + OpenClaw 每日监控
...
- agent-reach check-update: 检查 GitHub 最新版本,展示更新内容
- agent-reach watch: 快速健康检查+版本检查,为定时任务设计
- 全部正常只输出一行
- 有问题才展开详情
- install.md 新增 Step 5: OpenClaw 用户可设置每日自动监控
- Agent 主动问用户要不要设定时任务
- 有问题才通知,没问题不打扰
2026-02-25 03:41:42 +01:00
Panniantong
0f4a59fdfc
fix: Windows 控制台 emoji 编码崩溃
...
Windows 默认控制台编码是 cp936(中文)或 cp1252(西文),
print() 输出 emoji 字符时直接 UnicodeEncodeError 崩溃。
在 cli.py 入口处添加 UTF-8 encoding wrapper,
用 errors='replace' 确保不会因为编码问题导致整个程序崩溃。
2026-02-25 02:41:14 +01:00
Panniantong
a860873237
docs: 补充 Cookie-Editor 插件推荐
2026-02-24 16:10:37 +01:00
Panniantong
8089022683
docs: 全网搜索改为需配置免费 Key,移到配置后解锁列
2026-02-24 16:07:25 +01:00
Pnant
e99acaa524
Update README.md
2026-02-24 22:59:52 +08:00
Panniantong
4223f1cfe9
docs: 加 Web 4.0 基建愿景
2026-02-24 15:59:18 +01:00
Panniantong
7ae45ac0a3
docs: Star 段落改为真诚口吻,不过度承诺
2026-02-24 15:57:41 +01:00
Panniantong
afd23e35d7
docs: 表格改为「装好即用 / 配置后解锁」双列,清晰表达功能层次
2026-02-24 15:56:58 +01:00
Panniantong
d42ebea4ff
docs: 表格按配置难度排序 + 简化配置说明 + 加 Star 价值说明
...
- 平台表格从易到难排列(零配置→Cookie→代理→MCP)
- 删除第二个操作表格,配置说明统一写在'你需要做什么'列
- 统一口吻:不知道怎么配就告诉 Agent,它会引导你
- 删除'状态一目了然'段落(信息已在表格覆盖)
- 开头和结尾加 Star 价值说明:持续更新、新渠道、平台封了我们修
2026-02-24 15:52:26 +01:00
Pnant
fcd747ae4f
Update README.md
2026-02-24 22:45:43 +08:00
Panniantong
ac63a5dc55
docs: install.md 恢复有用细节,保留简洁指令
...
保留:
- Cookie 配置步骤(需要用户操作,Agent 做不了)
- 代理配置说明(含推荐服务商)
- 完整命令参考表(12 条命令)
- 自动安装说明
去掉的只有:9 行排错对照表(Agent 自己能搞定)
2026-02-24 15:38:57 +01:00
Panniantong
27847cd68b
docs: 重写痛点场景 + 平台表格改为用户视角
...
- 痛点从4条技术描述扩展为9条真实用户场景
- 平台表格按阅读/搜索/发布拆列,标注用户需要做什么
- 新增配置操作指南表(跟Agent说什么/花多久/花多少钱)
- 删除重复的'按需解锁'段落,信息已整合到平台表格
2026-02-24 15:36:02 +01:00
Panniantong
05452e5b54
simplify: install.md 只说目标,不说怎么修——Agent 自己会
...
install.md 核心指令:
- 目标:所有渠道都 ✅
- 遇到问题自己修,不要停
- 只有需要用户提供的东西(密码/cookie/key)才问用户
- 最后跑 doctor 汇报结果
2026-02-24 15:34:50 +01:00
Panniantong
db3f292228
feat: 添加 Agent 自修复提示——让用户的 Agent 自己解决安装问题
...
核心改动:
1. install.md 加入 Agent 指令:'You are a capable AI Agent. If a tool
fails, try another method. Don't give up after one attempt.'
2. install.md 加入常见问题自修复表(9 种场景 + 对应解法)
3. CLI 错误输出改为 Agent-friendly 语气,给出替代方案而非只说失败
4. install 结束时如果有未激活渠道,提示 Agent 自行修复
2026-02-24 15:32:25 +01:00
Panniantong
d52520a17e
fix: 修复 _install_mcporter 函数丢失 + browser-cookie3 硬依赖 + 自动装 birdx
...
关键修复:
1. _install_mcporter() 函数定义被上次编辑误删(NameError 崩溃)
→ 恢复为独立函数
2. browser-cookie3 作为硬依赖在服务器上安装失败(缺 dbus/secretstorage)
→ 改为 optional[cookies]
3. birdx 不在自动安装流程中
→ _install_system_deps 增加自动 pip install birdx
install 流程现在完整覆盖:
gh CLI → Node.js → birdx → mcporter → Exa → XHS → cookies → test
2026-02-24 15:25:38 +01:00
Panniantong
51f73639e2
fix: install 自动安装 gh CLI + Node.js,加大 mcporter 超时
...
问题:新服务器上 gh CLI 和 Node.js 未安装,mcporter npm install 60s 超时
修复:
- 新增 _install_system_deps():自动安装 gh CLI (apt) + Node.js (nodesource)
- mcporter 超时从 60s → 120s
- install.md 更新:去掉过时的 exa-key/xhs-cookie 配置步骤
- install 流程:系统依赖 → mcporter → Exa 配置 → 环境检测 → 测试
2026-02-24 15:05:00 +01:00
Panniantong
47f2925b0d
chore: 添加一键完整测试脚本 test.sh
2026-02-24 14:23:53 +01:00
Panniantong
064ae75ca6
docs: 30秒 → 几分钟,更符合实际
2026-02-24 14:12:20 +01:00
Panniantong
c67478239e
docs: 加上 vibe coding 说明,欢迎提 bug
2026-02-24 14:09:41 +01:00
Panniantong
758002f136
docs: 精简贡献指南,去掉技术细节
...
- 删掉添加新渠道的代码示例和 3 步教程
- 删掉希望支持的渠道列表
- 简化为:想要新渠道提 Issue/PR,想本地加让 Agent clone 改就行
- 中英文同步
2026-02-24 13:57:48 +01:00
Panniantong
f2f2e19eac
docs: 更新 Twitter API 定价 — 已改为按量付费(2026-02)
...
X 官方 API 2026年2月改版:
- 旧: 固定月费 00/00/000
- 新: 按量付费(读推 /bin/bash.005/条,读用户 /bin/bash.01,发推 /bin/bash.01)
- X 官方示例:中等用量约 15/月
- birdx 仍然免费(Cookie 登录)
中英文 README 同步更新
2026-02-24 13:43:02 +01:00
Panniantong
8b00f73e84
docs: 重写设计理念 — 突出脚手架定位、可插拔架构、新渠道贡献指南
...
- 设计理念: 明确「脚手架不是框架」定位
- 项目结构: 每个文件标注可替换后端选项
- 添加新渠道: 3 步完整教程 + 代码示例
- 贡献指南: 希望支持的渠道列表(HN/Mastodon/Telegram/arXiv 等)
- 中英文 README 同步更新
2026-02-24 13:41:14 +01:00
Panniantong
7d0da09222
feat: 新增 YouTube/Bilibili/XHS 搜索 CLI 命令 + 修复 B站搜索
...
- cli.py: 新增 search-youtube / search-bilibili / search-xhs 子命令
- core.py: 新增 search_youtube / search_bilibili / search_xhs 方法
- bilibili.py: 搜索策略改为 yt-dlp → Exa fallback(服务器 IP 被 B站 412)
- 本地机器走 yt-dlp bilisearch(有 title/uploader)
- 服务器自动 fallback 到 Exa site:bilibili.com
- 修复 mcporter 输出解析(Title:/URL: 格式)
测试结果: 15/15 全通(8 read + 7 search)
2026-02-24 13:39:21 +01:00
Panniantong
88eaebe263
refactor: 统一所有渠道后端,对齐 research 技能
...
GitHub: REST API → gh CLI(官方工具,认证后完整能力)
Bilibili: 自写 API → yt-dlp(和 YouTube 统一后端,支持搜索 bilisearch)
YouTube: 新增搜索功能(ytsearch via yt-dlp)
README 中英文同步更新:
- 平台表格:小红书/Exa/GitHub/YouTube/B站 描述全部更新
- 选型表格:新增 gh CLI、xiaohongshu-mcp,更新 yt-dlp/Exa 描述
- 按需解锁:去掉 Exa Key 注册步骤(已自动配置)
- 配置难度说明:新增「自动配置」「mcporter」级别
2026-02-24 13:25:57 +01:00
Panniantong
bb9ce6f7f1
refactor: XHS + Exa 全面切换到 mcporter MCP 后端
...
- xiaohongshu.py: 删除网页爬取代码,100% 走 mcporter + xiaohongshu-mcp
- exa_search.py: 删除直接 API 调用,100% 走 mcporter + exa MCP(免 Key)
- cli.py install: 新增 _install_mcporter(),自动装 mcporter + 配置 exa/xhs
- cli.py configure: 移除 exa-key 和 xhs-cookie(不再需要)
- doctor.py: 更新 tier 1 描述
净减 166 行代码,架构更简单:
之前: 每个渠道两套后端代码(mcporter + fallback)
现在: 每个渠道一套后端(mcporter only)
2026-02-24 13:20:23 +01:00
Panniantong
4e0c008d42
feat: 小红书 + Exa 搜索支持 mcporter MCP 后端
...
小红书:
- 优先通过 mcporter + xiaohongshu MCP server(内部 API,不受反爬限制)
- Fallback 到 Cookie 网页爬取(原方案,服务器端可能被拦截)
- 新增 search() 方法支持搜索小红书内容
- doctor 检测 MCP 连接状态和登录状态
Exa 搜索:
- 优先通过 mcporter + Exa MCP server(OAuth 免 API Key)
- Fallback 到直接 API 调用(需 EXA_API_KEY)
- 解析 mcporter 输出的 Title/URL/Text 格式
两个渠道都从「必须配置才能用」变成「有 mcporter 就自动能用」
9/9 渠道全部可用
2026-02-24 13:04:55 +01:00
Panniantong
3efc8d1d55
fix: Reddit 子版块列表页支持 + --version 参数
...
- reddit.py: 新增 _parse_listing() 处理 /r/sub/hot|new|top 等列表页
之前只能读单个帖子,列表页直接报 ValueError
- cli.py: 添加 --version flag (标准 CLI 惯例)
2026-02-24 12:49:58 +01:00
Panniantong
30f11bb6e4
fix: remove dead code (unreachable return) in twitter.py check()
2026-02-24 12:39:00 +01:00
Panniantong
2d1b8658b6
fix: handle curly quotes in Twitter Jina fallback detection
...
Jina Reader returns smart/curly quotes (U+2019) instead of ASCII
apostrophes. Use apostrophe-free substrings for detection.
2026-02-24 12:38:25 +01:00
Panniantong
a5b7b93b1f
fix: improve error handling for Twitter Jina fallback and invalid URL inputs
...
- Twitter _read_jina now detects unusable X.com responses (JS-required pages)
and shows a friendly error instead of garbage HTML
- CLI read command now shows user-friendly messages for invalid URLs
and connection errors instead of raw HTTP exception traces
2026-02-24 12:36:57 +01:00
Panniantong
ac64f607e0
fix: 开头平台列表补上 YouTube(中英文同步)
2026-02-24 12:19:46 +01:00
Panniantong
94513cf1da
fix: Python badge 3.8+ → 3.10+ 对齐 pyproject.toml
2026-02-24 12:19:14 +01:00
Panniantong
ebbb69c372
polish: 全面清理旧名引用 + 英文 README 对齐中文版质量
...
- .gitignore/.env.example: agent-eyes → agent-reach
- README.md: 暂去掉 logo 图片标签(logo 待定)
- docs/README_en.md: 完全重写,对齐中文版的表格/徽章/结构
- SKILL.md: setup → configure
- sync-upstream.sh: 更新路径到 agent_reach/channels
- 提交 3 个 logo 候选文件(最终选定后改名 logo.png)
2026-02-24 12:15:30 +01:00
Panniantong
5c62a21f32
rename: Agent Eyes → Agent Reach
...
全局重命名:
- 包名: agent_eyes → agent_reach
- CLI: agent-eyes → agent-reach
- 类名: AgentEyes → AgentReach
- 显示名: Agent Eyes → Agent Reach
- GitHub: Panniantong/agent-eyes → Panniantong/Agent-Reach
所有 36 个测试通过,CLI/doctor/read/search 全部正常。
2026-02-24 10:25:46 +01:00
Panniantong
4b0ae20fd7
README: 对标爆火开源项目标准重写
...
研究了 Daytona(4K星首周)、yt-dlp(148K)、Jina Reader(9.8K)、OpenClaw 等项目的 README 模式。
新增/改进:
1. 居中 Logo + 标题 + 徽章区(License、Python、Stars)
2. 顶部导航链接
3. '为什么需要' → 痛点表格化(Twitter 00/月、Reddit 403...)
4. 安心清单改成表格,更整齐
5. 设计理念里选型理由改成表格
6. 加了 贡献 section(降低参与门槛)
7. 加了 LICENSE 文件
8. logo 占位(待设计)
2026-02-24 10:17:52 +01:00
Panniantong
06a729e5a7
README: 加用户安心清单——免费、安全、持续更新、兼容所有 Agent
...
在开头加了'你可能关心的几件事':
- 完全免费(唯一可能花钱的是代理,本地不需要)
- Cookie 只存本地,代码开源可审查
- 持续跟进上游工具更新
- 适配所有主流 Agent 平台
- 出问题 doctor 一眼可知
2026-02-24 10:12:10 +01:00
Panniantong
e6f6eff9d4
README: 重写开头和设计理念
...
开头:从'Agent 是瞎子'改为精确描述真实痛点——Agent 能上网,但社媒和私域平台(信息密度最高的地方)各有门槛,一个个踩坑很烦。
设计理念:从'胶水不是框架'改为'Agent 初始化脚手架'——
帮你做完选型和配置,每个平台选了社区最好的开源工具,
每个文件 ~50 行,后端随时可换。列出每个选型的理由。
2026-02-24 10:09:57 +01:00
Panniantong
3fe0948e6d
README: 去掉 CLI/Python/MCP,全部改成用户视角
...
用户不需要知道命令、API、MCP Server。
整个 README 只讲一件事:复制一句话给 Agent → 装好 → 用自然语言跟 Agent 说话。
删掉:接入方式(CLI/Python/MCP)、速查表(命令列表)
合并:'装好就能用' + '你的 Agent 能做什么' → 统一为场景示例
简化:'按需解锁' 从代码块改为自然语言引导
2026-02-24 10:05:43 +01:00
Panniantong
38bf407c3a
精确描述每个渠道的能力层次
...
核心修改:
- GitHub: 零配置=公开仓库可读可搜,配置 gh/token 后=Fork、Issue、PR、Review 全部可用
- Reddit: 三层能力——Exa 搜索(免费)→代理读帖子→OAuth Bot 高级操作(发帖等)
- 小红书: 必须配 Cookie,没有降级方案,明确说明
- B站: 本地可用/服务器需代理,区分清楚
- Twitter: 零配置可读推文,birdx+Cookie 解锁搜索发推
每个渠道的 check() 方法都改为自定义逻辑,精确反映当前环境的实际能力。
2026-02-24 09:25:46 +01:00
Panniantong
2098dacd37
全中文输出 + 积极正向的状态提示
...
所有 doctor 输出和渠道描述改为中文。
状态提示从'不支持/需要配置'的语气改为'配置一下就能用'。
Before: ⬜ Reddit posts — Need config: reddit_proxy
After: ⬜ Reddit 帖子和评论 — 配个代理就能用
Before: ⬜ XiaoHongShu — Need config: xhs_cookie
After: ⬜ 小红书笔记 — 导入浏览器 Cookie 就能用
2026-02-24 09:14:41 +01:00
Panniantong
904f8dfb49
fix: doctor status must be honest — show real capability per channel
...
Before: everything under tier 0 showed ✅ with vague descriptions
After: each channel shows its actual capability and limitations
Changes:
- GitHub: 'Public repos only. Set github_token for private repos'
- Twitter: shows 'Full access' vs 'Read-only' depending on birdx
- Bilibili: ⚠️ warning on servers about potential IP blocks
- XiaoHongShu: friendly message when no cookie (was showing Jina 451)
- Doctor format: tier 0 items now show detailed status messages, not just ✅
- README: platform table updated to match reality (removed exaggerated claims)
- README: doctor example updated to show new honest format
2026-02-24 09:00:34 +01:00
Panniantong
07c6efbc7e
fix: 4 bugs found in full E2E usage testing
...
Bug 1: Reddit 403 due to short User-Agent in proxy test
Root cause: configure proxy test used 'Mozilla/5.0' (too short, Reddit rejects)
Fix: use full UA string matching the channel implementation
Bug 2: Reddit URL parsing broke on trailing slashes
Root cause: url.rstrip('/') + '.json' mangled URLs with query params
Fix: properly parse URL, clean path, reconstruct json URL
Bug 3: Reddit 403 without proxy showed raw HTTP error
Root cause: no error handling for 403/429 responses
Fix: friendly message suggesting proxy setup + Exa search alternative
Bug 4: XiaoHongShu without cookie showed Jina Reader 451 error
Root cause: fallback to Jina Reader which can't access XHS (legal block)
Fix: show clear message about needing cookies with setup instructions
Bug 5: Empty search query caused raw 422 API error
Root cause: no input validation before API call
Fix: check for empty query, show friendly message
All 36 unit tests passing.
2026-02-24 08:52:37 +01:00
Panniantong
afe3aceb61
fix: 2 real-usage bugs found in end-to-end testing
...
Bug 1: search-github/search-twitter silently returned empty
Root cause: result printing code was inside except block (never reached on success)
Fix: moved result display code outside try/except
Bug 2: Bilibili returned empty content when server IP is blocked
Root cause: API returns code -404 but code treated it as success with empty data
Fix: check API response code, show friendly message with proxy setup hint
Also: GitHub search results now correctly show stars/forks/language from extra dict
All found through real-usage E2E testing (not just install/config testing).
2026-02-24 08:44:29 +01:00
Panniantong
c851bd64b9
simplify: auto-everything in install command
...
Changes:
1. browser-cookie3 now in default deps (no separate pip install)
2. install --env=auto now auto-imports cookies on local computers
3. install auto-detects EXA_API_KEY from environment variables
4. install.md cut from 100 lines to 60 lines — two steps not five
Before: pip install → agent-eyes install → 'want search?' → 'want cookies?' → configure each
After: pip install → agent-eyes install (does everything automatically) → only ask about what's missing
Docker clean-room test: all passing, 0 bugs.
2026-02-24 08:37:55 +01:00
Panniantong
cf5b495ebf
docs: GitHub full capabilities via gh CLI
...
GitHub isn't just read+search — gh CLI enables:
create issues/PRs, comment, review, fork, star, manage releases
2026-02-24 07:57:47 +01:00
Panniantong
d588403669
docs: full channel table upfront with capabilities + difficulty
...
Major change: README now opens with a complete platform table showing:
- ALL 9 supported platforms
- What each can do (read/search/post/reply/like/collect)
- Configuration difficulty (零配置/免费Key/Cookie/代理)
- Which open-source tool powers each one
Key additions:
- Twitter: not just read — can post tweets and reply (via birdx)
- XiaoHongShu: full operations — post, comment, like, collect, search
- Sorted by importance: Web → Twitter → XHS → Search → GitHub → YouTube → Bilibili → RSS → Reddit
2026-02-24 07:52:21 +01:00
Panniantong
a9f5fd93d7
docs: 4 rounds of Steve Jobs polish on Chinese README
...
Round 1: Problem-solution structure, showcase underlying tools
Round 2: Too verbose - 4 'can't do' examples is repetitive, tightened
Round 3: Compact doctor output, restored quick-reference table,
cut code examples to essentials
Round 4: Opening paragraph tighter - one sentence for all pain points
Key: README doesn't say 'we can read URLs' (every tool does that).
It says 'here are the best open-source tools for each platform,
we glued them together so you install once and get everything.'
2026-02-24 07:37:16 +01:00
Panniantong
f8234e3b96
docs: rewrite README — showcase underlying tools, not generic capabilities
...
Core insight from Neo: 'reading a URL is not a feature — every AI tool does that'
New approach: introduce each underlying project and what makes it special:
- Jina Reader (9.8K⭐ ): any URL → clean Markdown, handles JS rendering
- yt-dlp (148K⭐ ): subtitles from 1800+ video sites, not just YouTube
- Exa: neural semantic search, not keyword matching
- birdx: Twitter without expensive API Key, just browser cookies
- feedparser (2.3K⭐ ): universal RSS/Atom parser
Framing: 'We find the best wheel for each job, then attach them all to your Agent'
2026-02-24 07:30:04 +01:00
Panniantong
e96ebdec88
docs: Chinese README as default, English in docs/
...
Chinese README polished 3 rounds:
- Round 1: direct translation
- Round 2: too dry, too many tables, too technical
- Round 3: conversational tone, scenario-driven, collapsible details
Key improvements:
- Opens with WHY not WHAT ('你的Agent很聪明,但是看不见')
- Install section explains WHERE to paste for newbies
- Features shown as bullet list not tables (better visual scan)
- Architecture hidden in collapsible section (most users don't care)
- 'Why Agent Eyes' section explains positioning clearly
- English version at docs/README_en.md
2026-02-24 07:22:35 +01:00
Panniantong
c40ffbd5ed
fix: 3 bugs found in Docker clean-room test
...
1. Install command: git+... requires git (many envs don't have it)
→ Changed to zip URL: pip install .../archive/main.zip
2. yt-dlp not in dependencies (shows warning in doctor)
→ Added yt-dlp to required dependencies
3. search-twitter/reddit shows raw 401 error without Exa key
→ Now shows friendly 'Exa API key not configured' message
2026-02-24 07:11:22 +01:00
Panniantong
deec966228
polish: reorder steps — search first (highest value), cookies second
...
Search (Exa) is more valuable to most users than cookie-based channels.
New order: install → search key → cookies → proxy → done
2026-02-24 07:03:12 +01:00