Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
fix(skill): use shell-safe mcporter arguments
realMisakaMikotoe4e00c60a3dc
diff --git a/agent_reach/guides/setup-exa.md b/agent_reach/guides/setup-exa.mdindex 3abc5ad0..3dc0ab89 100644--- a/agent_reach/guides/setup-exa.md+++ b/agent_reach/guides/setup-exa.md@@ -24,7 +24,7 @@ mcporter config add exa https://mcp.exa.ai/mcp --scope home### 3. 验证```bashagent-reach doctor | grep "Search"-mcporter call 'exa.web_search_exa(query: "test", numResults: 1)'+mcporter call exa.web_search_exa query="test" numResults=1```## 需要用户手动做的步骤diff --git a/agent_reach/guides/setup-reddit.md b/agent_reach/guides/setup-reddit.mdindex 5c121586..8e733dd3 100644--- a/agent_reach/guides/setup-reddit.md+++ b/agent_reach/guides/setup-reddit.md@@ -49,7 +49,7 @@ rdt read POST_ID如果你已经配置了 Exa(通过 mcporter),也可以通过 Exa 搜索 Reddit 内容:```bash-mcporter call 'exa.web_search_exa(query: "python best practices", numResults: 5, includeDomains: ["reddit.com"])'+mcporter call exa.web_search_exa query="site:reddit.com python best practices" numResults=5```rdt-cli 是当前推荐方案,无需额外配置即可使用。diff --git a/agent_reach/skill/SKILL.md b/agent_reach/skill/SKILL.mdindex 441cebc3..447f0271 100644--- a/agent_reach/skill/SKILL.md+++ b/agent_reach/skill/SKILL.md@@ -58,7 +58,7 @@ metadata:```bash# Exa 网页搜索-mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'+mcporter call exa.web_search_exa query="query" numResults=5# 通用网页阅读curl -s "https://r.jina.ai/URL"diff --git a/agent_reach/skill/SKILL_en.md b/agent_reach/skill/SKILL_en.mdindex 1d4e364a..78f26f9d 100644--- a/agent_reach/skill/SKILL_en.md+++ b/agent_reach/skill/SKILL_en.md@@ -62,7 +62,7 @@ these platforms — do not invent your own approach.**```bash# Exa web search-mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'+mcporter call exa.web_search_exa query="query" numResults=5# Read any web pagecurl -s "https://r.jina.ai/URL"diff --git a/agent_reach/skill/references/career.md b/agent_reach/skill/references/career.mdindex d67887bc..177716dd 100644--- a/agent_reach/skill/references/career.md+++ b/agent_reach/skill/references/career.md@@ -6,16 +6,16 @@ LinkedIn。```bash# 获取个人资料-mcporter call 'linkedin.get_person_profile(linkedin_username: "username", sections: "experience,education")'+mcporter call linkedin.get_person_profile linkedin_username="username" sections="experience,education"# 搜索人才-mcporter call 'linkedin.search_people(keywords: "AI engineer", location: "Shanghai")'+mcporter call linkedin.search_people keywords="AI engineer" location="Shanghai"# 获取公司资料-mcporter call 'linkedin.get_company_profile(company_name: "openai", sections: "posts,jobs")'+mcporter call linkedin.get_company_profile company_name="openai" sections="posts,jobs"# 搜索职位-mcporter call 'linkedin.search_jobs(keywords: "software engineer", location: "Remote", max_pages: 2)'+mcporter call linkedin.search_jobs keywords="software engineer" location="Remote" max_pages=2```> **需要登录**: 首次使用前运行 `uvx mcp-server-linkedin@latest --login`,保存有效登录态。diff --git a/agent_reach/skill/references/search.md b/agent_reach/skill/references/search.mdindex ced10db8..d571c2ef 100644--- a/agent_reach/skill/references/search.md+++ b/agent_reach/skill/references/search.md@@ -7,8 +7,8 @@ Exa AI 搜索引擎。高质量 AI 搜索引擎,适合查找技术文档、官方示例和相关网页。```bash-mcporter call 'exa.web_search_exa(query: "query", numResults: 5)'-mcporter call 'exa.web_search_exa(query: "library API code example", numResults: 5)'+mcporter call exa.web_search_exa query="query" numResults=5+mcporter call exa.web_search_exa query="library API code example" numResults=5```### 使用场景diff --git a/agent_reach/skill/references/social.md b/agent_reach/skill/references/social.mdindex 1d5b6d50..a2b6f47b 100644--- a/agent_reach/skill/references/social.md+++ b/agent_reach/skill/references/social.md@@ -38,13 +38,13 @@ opencli xiaohongshu user USER_ID -f yamlagent-reach configure xhs-cookies# 只读检查当前状态-mcporter call 'xiaohongshu.check_login_status()' --timeout 120000+mcporter call xiaohongshu.check_login_status --timeout 120000# 搜索-mcporter call 'xiaohongshu.search_feeds(keyword: "query")' --timeout 120000+mcporter call xiaohongshu.search_feeds keyword="query" --timeout 120000# 笔记详情+评论(feed_id 和 xsec_token 从搜索结果取)-mcporter call 'xiaohongshu.get_feed_detail(feed_id: "...", xsec_token: "...")' --timeout 120000+mcporter call xiaohongshu.get_feed_detail feed_id="..." xsec_token="..." --timeout 120000```> 首次调用会自动下载约 150MB 无头浏览器,务必带 `--timeout 120000`。diff --git a/agent_reach/skill/references/web.md b/agent_reach/skill/references/web.mdindex 5977b1c4..bbfa3c04 100644--- a/agent_reach/skill/references/web.md+++ b/agent_reach/skill/references/web.md@@ -18,13 +18,13 @@ curl -s "https://r.jina.ai/https://example.com/article"```bash# 读取网页内容 (Markdown 格式)-mcporter call 'web-reader.webReader(url: "https://example.com")'+mcporter call web-reader.webReader url="https://example.com"# 保留图片-mcporter call 'web-reader.webReader(url: "https://example.com", retain_images: true)'+mcporter call web-reader.webReader url="https://example.com" retain_images=true# 纯文本格式-mcporter call 'web-reader.webReader(url: "https://example.com", return_format: "text")'+mcporter call web-reader.webReader url="https://example.com" return_format="text"```**适用场景**: 需要更精确控制输出格式时使用。diff --git a/docs/install.md b/docs/install.mdindex 4c15e79d..1766eb05 100644--- a/docs/install.md+++ b/docs/install.md@@ -366,10 +366,10 @@ After installation, use upstream tools directly. See SKILL.md for the full comma| Instagram | `opencli` | `opencli instagram user nasa -f yaml` || GitHub | `gh` | `gh search repos "query"` || Web | `curl` + Jina | `curl -s "https://r.jina.ai/URL"` |-| Exa Search | `mcporter` | `mcporter call 'exa.web_search_exa(...)'` |+| Exa Search | `mcporter` | `mcporter call exa.web_search_exa query="..." numResults=5` || 小红书 | `opencli`(服务器 `mcporter`) | `opencli xiaohongshu search "query" -f yaml` || 小宇宙播客 | `transcribe.sh` | `bash ~/.agent-reach/tools/xiaoyuzhou/transcribe.sh <URL>` |-| LinkedIn | `mcporter` | `mcporter call 'linkedin.get_person_profile(...)'` |+| LinkedIn | `mcporter` | `mcporter call linkedin.get_person_profile linkedin_username="..."` || RSS | `feedparser` | `python3 -c "import feedparser; ..."` |> 多后端平台以 `agent-reach doctor --json` 的 `active_backend` 为准。diff --git a/docs/troubleshooting.md b/docs/troubleshooting.mdindex fea4c4c3..c38a9681 100644--- a/docs/troubleshooting.md+++ b/docs/troubleshooting.md@@ -52,7 +52,7 @@ proxychains twitter search "test" -n 1twitter-cli 不可用时,可以直接用 Exa 搜索 Twitter 内容:```bash-mcporter call 'exa.web_search_exa(query: "site:x.com 搜索词", numResults: 5)'+mcporter call exa.web_search_exa query="site:x.com 搜索词" numResults=5```### 方案 4:检查认证diff --git a/tests/test_skill_command.py b/tests/test_skill_command.pyindex 33733ae7..4659099b 100644--- a/tests/test_skill_command.py+++ b/tests/test_skill_command.py@@ -3,6 +3,7 @@import importlib.resourcesimport os+import reimport tempfileimport unittestfrom argparse import Namespace@@ -37,6 +38,22 @@ class TestSkillCommand(unittest.TestCase):self.assertNotIn("exa.get_code_context_exa", search_reference)self.assertNotIn("get_code_context_exa(", search_reference)+ def test_mcporter_examples_use_shell_safe_named_arguments(self):+ """Packaged commands must survive PowerShell and POSIX parsing."""+ root = Path(__file__).resolve().parents[1]+ markdown_files = [+ *(root / "agent_reach" / "skill").rglob("*.md"),+ *(root / "agent_reach" / "guides").rglob("*.md"),+ root / "docs" / "install.md",+ root / "docs" / "troubleshooting.md",+ ]+ function_call = re.compile(r"mcporter call\s+['\"][^'\"\r\n]+\(")++ for markdown_file in markdown_files:+ with self.subTest(markdown_file=markdown_file):+ content = markdown_file.read_text(encoding="utf-8")+ self.assertNotRegex(content, function_call)+def test_linkedin_reference_uses_current_tool_contract(self):"""LinkedIn examples should use the current server and parameters."""career_reference = (@@ -46,24 +63,24 @@ class TestSkillCommand(unittest.TestCase):)self.assertIn(- "linkedin.get_person_profile("- 'linkedin_username: "username", '- 'sections: "experience,education")',+ "linkedin.get_person_profile "+ 'linkedin_username="username" '+ 'sections="experience,education"',career_reference,)self.assertIn(- 'linkedin.search_people(keywords: "AI engineer", '- 'location: "Shanghai")',+ 'linkedin.search_people keywords="AI engineer" '+ 'location="Shanghai"',career_reference,)self.assertIn(- 'linkedin.get_company_profile(company_name: "openai", '- 'sections: "posts,jobs")',+ 'linkedin.get_company_profile company_name="openai" '+ 'sections="posts,jobs"',career_reference,)self.assertIn(- 'linkedin.search_jobs(keywords: "software engineer", '- 'location: "Remote", max_pages: 2)',+ 'linkedin.search_jobs keywords="software engineer" '+ 'location="Remote" max_pages=2',career_reference,)self.assertNotIn("linkedin-scraper.", career_reference)