Pnant and Panniantong
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 and Panniantong
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 and Panniantong
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 and Panniantong
94b428b0b9
refactor: rewrite SKILL.md as pure usage guide (324→160 lines) ( #78 )
...
SKILL.md was mixing installation/configuration with usage commands.
Now it's a pure usage guide per skill-creator conventions:
- Description includes ALL platform trigger words (search, read,
browse for each of 13 channels) so agents load it when users
ask to search/read any platform
- Body is concise command reference only — no install/config
instructions (those belong in install.md)
- Removed duplicate workspace rules explanation
- Removed cookie setup, proxy config, and channel setup sections
- 324 → 160 lines (51% reduction in context tokens)
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-05 17:19:23 +08:00
Pnant and Panniantong
105b477a31
docs: add update one-liner to English README + update.md ( #77 )
...
- English README: added update one-liner in hero section and Quick Start
- update.md: added English version of the one-liner for humans
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-05 15:43:57 +08:00
Pnant and Panniantong
e5e20a1154
fix(windows): use shutil.which() for npm subprocess calls ( #73 )
...
Two subprocess.run(["npm", ...]) calls in undici installation were
using bare command name, which fails on Windows where npm is
installed as npm.cmd. Now resolves full path via shutil.which()
first, consistent with all other subprocess calls.
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-05 10:32:02 +08:00
Pnant and Panniantong
b4d189b536
fix: enforce workspace isolation to prevent agent pollution ( #57 ) ( #72 )
...
Problem: After installing Agent Reach, agents may clone repos, create
files, or write output into the workspace directory, gradually polluting
the user's project. Over time this degrades the agent experience.
Fix:
- SKILL.md: add Workspace Rules section — never create files in workspace
- install.md: add Directory Rules table, explicit boundary about workspace
- install.md: all git clone commands now target ~/.agent-reach/tools/
- update.md: add workspace warning
- cli.py: install creates ~/.agent-reach/tools/ directory
All agent-facing docs now enforce: /tmp for temp, ~/.agent-reach/ for
persistent data, workspace stays untouched.
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-04 18:40:31 +08:00
Pnant and Panniantong
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 and Panniantong
ca29c4fee5
release: v1.3.0 ( #70 )
...
ci / test (3.10) (push) Has been cancelled
ci / test (3.11) (push) Has been cancelled
ci / test (3.12) (push) Has been cancelled
New:
- WeChat Official Account channel (search + read)
- Search via miku_ai (Sogou WeChat search)
- Read via Camoufox (stealth Firefox, bypasses anti-bot)
- 13 channels total
Fixed:
- Windows encoding: text=True → encoding='utf-8' in all subprocess calls (#64 )
- Windows .cmd resolution: use shutil.which() paths (#64 )
Docs:
- Clarified agent-reach has no read/search commands (#58 , #59 )
- Fixed xiaohongshu API function names in SKILL.md (#65 )
- Added CONTRIBUTING.md (#62 )
- Updated README (zh + en) with WeChat channel
Version bumps: pyproject.toml, __init__.py, test_cli.py
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-04 18:18:18 +08:00
Pnant and Panniantong
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
Pnant and Panniantong
476935be92
feat: add WeChat search via miku_ai (sogou) ( #68 )
...
- wechat channel now supports both search and read
- Search: miku_ai (sogou weixin search) → article list with URLs
- Read: camoufox (stealth Firefox) → full Markdown content
- Doctor shows granular status (search only / read only / both)
- SKILL.md updated with search + read workflow examples
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-04 18:02:05 +08:00
Pnant and Panniantong
4f4ad99d49
feat: add WeChat Official Account channel ( #54 ) ( #67 )
...
New channel: wechat (微信公众号文章)
- Backend: wechat-article-for-ai (Camoufox stealth browser)
- Can read mp.weixin.qq.com article URLs → clean Markdown
- Bypasses WeChat anti-bot detection via stealth Firefox
- Doctor checks for camoufox package availability
- SKILL.md updated with usage examples
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-04 17:53:39 +08:00
Pnant and Panniantong
a91a74d880
fix: Windows encoding + .cmd subprocess resolution ( #64 ) ( #66 )
...
- Replace text=True with encoding='utf-8', errors='replace' in all
subprocess.run calls (channels + cli.py) to fix GBK decode errors
on Chinese Windows systems
- Use shutil.which() resolved paths in channel subprocess calls to
handle Windows .cmd wrappers (npm global installs)
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-04 17:30:11 +08:00
Pnant and Panniantong
1a61a2cc81
docs: clarify agent-reach has no read/search commands ( #59 )
...
- Remove dead '# ── read ──' placeholder comment in cli.py
- Reword SKILL.md to make it explicit that agent-reach is an
installer/config tool, not a content fetcher
- Addresses confusion from issue #58
Co-authored-by: Panniantong <panniantong@users.noreply.github.com >
2026-03-04 14:33:38 +08:00
Pnant
932837ff9a
Merge pull request #52 from Panniantong/fix/twitter-cookie-sync-issue50
...
fix: sync Twitter cookies to xreach session.json on configure
2026-02-28 20:29:38 +08:00
Panniantong
4f52942260
improve: add chmod 0o600 for session.json (from PR #51 suggestion)
2026-02-28 13:28:14 +01:00
Panniantong
3c1a04a587
fix: sync Twitter cookies to xreach session.json on configure
...
When running 'agent-reach configure twitter-cookies', credentials are now
automatically written to ~/.config/xfetch/session.json so that 'xreach auth
check' works without manual intervention.
Preserves existing session.json fields if the file already exists.
Falls back gracefully if the sync fails (still saves to agent-reach config).
Fixes #50
2026-02-28 11:11:55 +01:00
Pnant
6a28b215af
Merge pull request #49 from Panniantong/fix/ci-test-github-check
...
fix: CI 测试修复 — gh CLI 在 CI 环境不存在
2026-02-27 20:41:30 +08:00
Panniantong
a881db4261
fix: CI test — allow github channel 'warn' when gh CLI not installed
...
GitHub Actions runners don't have gh CLI pre-installed, so the doctor
check returns 'warn' instead of 'ok'. Allow both in the test assertion.
2026-02-27 13:39:34 +01:00
Pnant
875f0987a6
Merge pull request #48 from Panniantong/fix/yt-bilibili-cookie-docs
...
fix: YouTube 需要 JS runtime — install 自动配置 Node.js
2026-02-27 18:46:32 +08:00
Panniantong
0d1a33236e
fix: YouTube requires JS runtime — auto-configure Node.js in install
...
yt-dlp now requires an external JS runtime (deno or Node.js) for YouTube.
Since agent-reach already installs Node.js, we configure yt-dlp to use it:
1. cli.py: install writes '--js-runtimes node' to ~/.config/yt-dlp/config
2. youtube.py: doctor checks JS runtime availability and config
3. SKILL.md: updated YouTube section with accurate troubleshooting
Bilibili note: 412 errors are IP-based (needs proxy), not cookie-related.
Fixes #47
2026-02-27 11:45:39 +01:00
Panniantong
e620a1db8f
docs: add cookie/proxy warnings for YouTube and Bilibili in SKILL.md
...
YouTube may trigger 'Sign in to confirm you're not a bot' on server IPs.
Bilibili may return 412 on non-residential IPs.
Added --cookies-from-browser fallback examples for both channels.
Fixes #47
2026-02-27 11:25:29 +01:00
Pnant
15a2961dfa
Merge pull request #46 from Panniantong/migrate-bird-to-xreach
...
feat: 迁移 Twitter 后端 bird → xreach CLI
2026-02-27 15:21:25 +08:00
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
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
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