工具选择
- GitHub repo、issue、PR、comment、release、workflow 等资源 URL 优先使用
github-cli。 - 如果
gh或 GitHub API 能取得任务所需内容,不要同时调用fetch-url。 - 仅当
github-cli无法取得所需页面内容,或目标并非其支持的 GitHub 资源时,才使用本 skill 回退。
URL 仅支持 http / https。
默认自动探测本地 Chromium 系浏览器路径;未探测到时需安装 Playwright 浏览器:
uv run playwright install chromium
参数:
--output:将输出写入文件(默认 stdout)。--timeout-ms:Playwright 导航超时(毫秒,默认 60000)。--browser-path:指定本地 Chromium 系浏览器路径(默认自动探测)。--output-format:输出格式(默认markdown),支持csv、html、json、markdown、raw-html、txt、xml、xmltei;raw-html直接输出渲染后的 HTML(不经 trafilatura)。--fetch-strategy:仅markdown可用,支持auto、agent、jina、browser。默认auto。
--fetch-strategy 常用值:
auto:默认选择。agent:优先用原站 Markdown 协商。jina:优先用 Jina Reader。browser:直接用本地 Playwright。
环境变量:
- 可设置
JINA_API_KEY提升 Jina Reader 限流:JINA_API_KEY=your-token ./scripts/fetch_url.py ...
示例:
./scripts/fetch_url.py https://example.com --output ./page.md --timeout-ms 60000
./scripts/fetch_url.py https://example.com --fetch-strategy jina
JINA_API_KEY=your-token ./scripts/fetch_url.py https://example.com --fetch-strategy jina
./scripts/fetch_url.py https://example.com --fetch-strategy browser
./scripts/fetch_url.py https://x.com/jack/status/20 --output-format markdown
./scripts/fetch_url.py https://x.com/jack/status/20 --output-format markdown --fetch-strategy browser
Reference:scripts/fetch_url.py