用途:Decodo 是一个网页抓取 API,返回干净的网页数据,用户无需自行管理代理、浏览器或反爬逻辑。本技能指导通过 decodo CLI(首选)、托管 MCP 服务器(无 shell 时)或原始 HTTP API(兜底)调用它。
适用场景:当任务涉及 JS 密集、地域受限、限流或带反爬/CAPTCHA 的页面;普通抓取返回 403/429/空响应/CAPTCHA;需要 Google 或 Bing 搜索结果;需要 Amazon、Walmart、Target 商品或搜索页数据;需要 Reddit、TikTok、YouTube 社交数据;或需要渲染页面截图时使用。若基础 curl 可用且不涉及上述情况,则无需 Decodo。
主要能力:抓取网页(默认 markdown)、按国家地理定位、Google/Bing SERP 搜索、截图、以及由实时 API schema 生成的各类目标(如 google-search、amazon-product、reddit-post)。优先使用专用目标而非通用 scrape,可获得更干净的结构化数据。
使用方式:先检查 CLI 是否可用:decodo whoami 或 npx -y @decodo/cli whoami。认证需从 https://dashboard.decodo.com/web-data/playground 获取 API key,推荐设置环境变量 export DECODO_AUTH_TOKEN='<api-key>',或非交互保存 decodo setup --token '<api-key>'。安装可选:curl -fsSL https://decodo.github.io/cli/install.sh | sh 或 npm install -g @decodo/cli。常用命令:decodo scrape https://example.com、decodo search "query" --limit 3、decodo screenshot https://example.com -o shot.png、decodo targets 查看目标。输出可用 --parse、--full、--format ndjson、--pretty、-o 等控制,建议管道接 jq 只取所需字段以节省上下文。退出码 0 成功、3 认证错误、5 限流、6 超时、7 网络错误,可据此自纠。
限制:需有效 API key;免费账户最多 2K 请求(资料所述);截图必须写入文件而非 stdout;--parse 仅适用于支持的目标命令;无 shell 时改用 MCP 或原始 HTTP API。密钥应视为机密,不要从配置文件读取或打印。