Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

fix(skill): use shell-safe mcporter arguments

realMisakaMikotoe4e00c60a3dc
diff --git a/agent_reach/guides/setup-exa.md b/agent_reach/guides/setup-exa.md
index 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. 验证
```bash
agent-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.md
index 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.md
index 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.md
index 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 page
curl -s "https://r.jina.ai/URL"
diff --git a/agent_reach/skill/references/career.md b/agent_reach/skill/references/career.md
index 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.md
index 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.md
index 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 yaml
agent-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.md
index 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.md
index 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.md
index fea4c4c3..c38a9681 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -52,7 +52,7 @@ proxychains twitter search "test" -n 1
twitter-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.py
index 33733ae7..4659099b 100644
--- a/tests/test_skill_command.py
+++ b/tests/test_skill_command.py
@@ -3,6 +3,7 @@
import importlib.resources
import os
+import re
import tempfile
import unittest
from 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)