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

50 commits

Author SHA1 Message Date
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
b6d135c977 docs: 小红书配置方式统一为「告诉 Agent 帮我配」 2026-02-25 16:03:50 +01:00
Panniantong
545a6c5761 docs: 新渠道配置方式统一为「告诉 Agent 帮我配」 
跟其他渠道风格一致，不单独列限制说明。
具体配置步骤都在 install.md 里，Agent 会自动引导。
 2026-02-25 15:27:51 +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
fe7ed1656b merge: 解决与 main 分支的冲突 2026-02-25 13:16:45 +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
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
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
27847cd68b docs: 重写痛点场景 + 平台表格改为用户视角 
- 痛点从4条技术描述扩展为9条真实用户场景
- 平台表格按阅读/搜索/发布拆列，标注用户需要做什么
- 新增配置操作指南表（跟Agent说什么/花多久/花多少钱）
- 删除重复的'按需解锁'段落，信息已整合到平台表格
 2026-02-24 15:36:02 +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
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
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
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
33c7b773e0 feat: add Agent-readable install guide (one URL to rule them all) 
Users just paste one line to their AI Agent:
'Install Agent Eyes: https://raw.githubusercontent.com/Panniantong/agent-eyes/main/docs/install.md'

The Agent reads the guide, installs, configures, and reports back.
Inspired by oh-my-opencode's installation flow.

Also updated README: new tagline, architecture diagram reflects
pure-glue design, updated credits.
 2026-02-24 05:46:03 +01:00
Panniantong
8eab038cb9 v1.0.0 — Agent Eyes: search + read the entire internet 
Major restructure from x-reader fork to independent project:

Architecture:
- readers/ — content extraction from 10+ platforms (based on x-reader, MIT)
- search/ — semantic search via Exa, GitHub API, birdx (NEW)
- config.py — configuration management (~/.agent-eyes/config.yaml) (NEW)
- doctor.py — environment health checker (NEW)
- core.py — AgentEyes unified entry point (NEW)
- cli.py — full CLI: read, search, setup, doctor (NEW)
- integrations/mcp_server.py — 8 MCP tools (NEW)
- guides/ — 6 Agent-readable setup guides (NEW)
- integrations/skill/ — OpenClaw Skill package (NEW)

Platforms (zero config):
- Web pages, GitHub, Bilibili, YouTube, RSS, single tweets

Platforms (one free API key):
- Web search, Reddit search, Twitter search (via Exa)

Platforms (optional setup):
- Reddit full reader, Twitter advanced, WeChat, XiaoHongShu

Tests: 34/34 passing

Credits: Built on x-reader by @runes_leo (MIT License)
 2026-02-24 04:00:47 +01:00
Panniantong
3a3a0101cf Agent Eyes v1.0.0 — search + read the entire internet 
Based on x-reader by @runes_leo (MIT License). Extended with:
- Reddit support (posts + comments, proxy support)
- GitHub support (repos, issues, PRs)
- Web search via Exa semantic search
- Reddit search (bypasses IP blocks via Exa)
- GitHub search (repos by stars)
- Renamed package: x_reader → agent_eyes
- New MCP tools: search, search_reddit, search_github
- Agent-first positioning and documentation
 2026-02-24 03:07:50 +01:00
Panniantong
ee2ad83b12 Initial: forked from runesleo/x-reader (MIT License) - thank you @runes_leo! 2026-02-24 03:00:05 +01:00