marketing-shibata50/Agent-Reach
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
81 commits 1 branch 0 tags 1.4 MiB
Commit graph

81 commits

This branch
This branch
All branches
Author SHA1 Message Date
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