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

83 commits

Author SHA1 Message Date
Kada Liao
f52fb67232 docs: add V2EX channel to README and CHANGELOG (v1.3.0) 2026-03-12 21:55:26 +08:00
Pnant
ba565bd096
fix: switch wechat-article-for-ai to Panniantong fork (BS4 4.12 fix) (#150) 
Upstream bzd6661/wechat-article-for-ai has a bug where Tag.new_tag
is None in BS4 4.12+. Our fork fixes this.

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-11 17:34:20 +08:00
Pnant
70a0bb8af8
fix(docs): correct OpenClaw exec permission instructions (#142) 
- Replace invalid `/config set exec.allow true` with correct
  `openclaw config set tools.profile "coding"`
- Fix config filename: config.json → openclaw.json
- Update explanation to reference tools.profile system

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-10 14:38:46 +08:00
Pnant
f5f4dea075
docs: add OpenClaw for Enterprise to friendly links (#141) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-10 14:20:31 +08:00
Pnant
233cc6fba8
docs: add friendly links section (FluxNode) (#140) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-10 14:18:06 +08:00
Pnant
ae5812cf7f
docs: remove personal WeChat QR, keep group QR only (#138) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-10 10:42:46 +08:00
Pnant
6af00ce4da
Update README.md 2026-03-10 10:41:20 +08:00
Pnant
3321bf7d34
docs: add WeChat community group QR code (#137) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-10 10:39:40 +08:00
Pnant
00d80d2169
remove: drop Boss直聘 channel (non-functional) (#135) 
Boss直聘 channel removed entirely — upstream mcp-bosszp
triggers account-level bans, making it unusable in practice.

Removed from: channel registry, README (CN/EN), install.md,
SKILL.md, tests, credits.

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-10 10:14:59 +08:00
Pnant
16733df4fc
fix: bust Star History chart cache (v=20260309, 7.5K+ stars) (#131) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-09 20:29:53 +08:00
Pnant
6ddcfe2b57
Update contact information in README.md 2026-03-09 17:01:44 +08:00
Pnant
0d91d6834a
Update README.md 2026-03-09 17:01:18 +08:00
Pnant
c912051173
feat: 新增小宇宙播客转文字渠道 (#124) 
* feat: add Xiaoyuzhou podcast transcription channel

- New channel: 小宇宙播客 (xiaoyuzhoufm.com) → full text transcript
- Uses Groq Whisper API (free, no credit card needed)
- Auto-downloads audio, converts to low-bitrate MP3, splits by 25MB limit
- Supports any length podcast with automatic chunking
- Script installed to ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh
- User just needs: agent-reach configure groq-key gsk_xxxxx
- Updated README (CN/EN), install.md, pyproject.toml

* docs: clarify Xiaoyuzhou setup — free key, limitations, step-by-step

---------

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-09 00:34:22 +08:00
Pnant
22d7ad766a
docs: add Twitter/X to contact section (#122) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-09 00:20:07 +08:00
Pnant
5895f3992d
docs: add email to contact section (#121) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-09 00:19:02 +08:00
Pnant
9129fc5f27
Update README.md 2026-03-09 00:15:20 +08:00
Pnant
3fe100cd9a
docs: add contact section with WeChat QR code (#120) 
Add author contact section to both Chinese and English READMEs.
Placed after Credits, before License — clean and non-intrusive.

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-08 22:51:00 +08:00
Pnant
0a5c06633c
docs: add OpenClaw exec permission prerequisite to README (#117) 
Fixes #110 and #115. Since OpenClaw 2026-01 disabled the exec tool by
default, users on OpenClaw can't run any agent-reach commands unless
exec is explicitly enabled.

Added:
- Warning callout before '快速上手' explaining exec requirement for
  OpenClaw users with the exact config command to use
- Note in the FAQ 'Compatible with Claude Code / OpenClaw...' entry
  with the same fix instructions

Closes #110
Closes #115

Co-authored-by: neo-minion1 <bot@openclaw.ai>
 2026-03-08 22:25:52 +08:00
Pnant
fedbf95f61
feat: add Weibo as default-install channel via Panniantong fork (#118) 
- Weibo now auto-installs during 'agent-reach install' (no login needed)
- Uses Panniantong/mcp-server-weibo fork with visitor passport auth fix
- Works from overseas servers without proxy or cookies
- Updated README (CN/EN), install.md, and channel check to point to fork
- 10 tools: trending, search content/users/topics, profile, feeds, comments

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-08 22:25:40 +08:00
Pnant
df34436942
docs: add Star History chart to README (#81) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-05 21:33:40 +08:00
Pnant
cd94706d3b
feat: auto-install WeChat article tools during install (#80) 
* feat: auto-install WeChat article tools during agent-reach install

WeChat (微信公众号) deps are now auto-installed during 'agent-reach install':
- Python packages: camoufox[geoip], markdownify, beautifulsoup4, httpx, miku_ai
- Tool repo: wechat-article-for-ai cloned to ~/.agent-reach/tools/

No login or configuration needed — works out of the box like YouTube/RSS.
Updated README tables to reflect zero-config status.
Also covers safe mode and dry-run.

* feat: auto-install WeChat + add channel-setup reference to SKILL.md

1. WeChat auto-install during 'agent-reach install':
   - pip install camoufox[geoip], markdownify, bs4, httpx, miku_ai
   - clone wechat-article-for-ai to ~/.agent-reach/tools/
   - covers safe mode and dry-run
   - README tables: WeChat → zero-config

2. SKILL.md improvements:
   - Added 'configure' triggers to description
   - Added references/channel-setup.md with install steps for all
     login-required platforms (Twitter, XHS, Douyin, LinkedIn, Boss)
   - Principle: user only provides cookies, agent does everything else

* simplify: point to install.md URL instead of bundled reference

No need to maintain a separate channel-setup.md. Just tell agents
to fetch install.md when they need setup instructions.

---------

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-05 18:29:33 +08:00
Pnant
35073aed54
docs: make WeChat row consistent with other channels (#79) 
Changed '怎么配' column from raw pip command to '告诉 Agent「帮我配微信公众号」',
matching the pattern of all other channels. Updated both Chinese and English READMEs.

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-05 18:08:35 +08:00
Pnant
27d3d545e6
docs: add one-line update guide (#71) 
- New docs/update.md for AI agents to follow
- README: add update one-liner next to install one-liner
- Same pattern: copy one line to your agent, it handles the rest

Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-04 18:25:17 +08:00
Pnant
49d05b7023
docs: add WeChat channel to README (zh + en) (#69) 
Co-authored-by: Panniantong <panniantong@users.noreply.github.com>
 2026-03-04 18:06:47 +08:00
Panniantong
62aacf38b5 feat: migrate Twitter backend from bird CLI to xreach CLI 
bird CLI (@steipete/bird) is deprecated and no longer maintained.
xreach CLI (xreach-cli on npm) is our maintained fork with:
- Fixed SearchTimeline (POST + updated query ID)
- Built-in proxy rotation support
- Additional features (DMs, notifications, lists)

Changes across 11 files:
- channels/twitter.py: detect xreach instead of bird/birdx
- cli.py: install/doctor/uninstall all reference xreach-cli
- SKILL.md: updated command examples (bird read → xreach tweet)
- guides/setup-twitter.md: rewritten for xreach
- docs/troubleshooting.md: updated proxy guidance
- README.md + README_en.md: all references updated
- config.py: twitter_bird → twitter_xreach
- core.py, mcp_server.py: comment updates

npm package: https://www.npmjs.com/package/xreach-cli
Source: https://github.com/Panniantong/xfetch
 2026-02-27 08:17:51 +01: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
Panniantong
f269667a34 docs: 添加 Cookie 登录封号风险提醒，强调使用小号 
- README: Cookie 安全建议新增封号风险说明
- install.md: Security tip 补充 account ban 风险
- SKILL.md: Cookie 导入段落加封号提醒
 2026-02-26 15:13:25 +01: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
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
Daiyimo
9c6c04c800 feat: add uninstall command; fix utf-8 encoding and minor cleanups 2026-02-26 16:01:22 +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
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
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
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