用途:该技能用于 XCrawl 搜索任务,包括关键词搜索请求设计、位置与语言控制、结果分析,以及后续的抓取或爬取衔接。默认行为为原始透传,直接返回上游 API 响应体。
主要能力:调用 POST /v1/search 接口,基础地址为 https://run.xcrawl.com,请求头需携带 Authorization: Bearer <XCRAWL_API_KEY>。请求体支持 query(必填)、location(默认 US)、language(默认 en,ISO 639-1)、limit(默认 10,范围 1-100)。响应包含 search_id、endpoint、version、status、query、data、started_at、ended_at、total_credits_used 等字段;具体结果结构由实现定义,并含 credits_used、credits_detail 等计费字段。
使用方式:使用前需创建本地配置文件 ~/.xcrawl/config.json,写入 XCRAWL_API_KEY,仅从该文件读取密钥,不依赖全局环境变量。运行时仅申请 curl 和 node 权限,不申请 Python、shell 辅助脚本或其他运行时权限。示例:curl -sS -X POST "https://run.xcrawl.com/v1/search" -H "Content-Type: application/json" -H "Authorization: Bearer ${API_KEY}" -d '{"query":"AI web crawler API","location":"US","language":"en","limit":20}'。也可用 node 的 fetch 调用。
适用场景:需要按关键词检索并保留原始 API 响应,或为后续爬取、抓取准备搜索结果的场景。
限制:使用 API 会消耗积分;无账号或积分时需前往 https://dash.xcrawl.com/ 注册,注册后可激活免费 1000 积分方案。不得声称 API 未提供的排名保证,不得编造不可用的过滤条件或响应字段,不应在核心逻辑中硬编码特定提供方的工具模式。除非用户明确要求,否则不生成相关性摘要。输出应包含所用端点、请求载荷、原始响应体及失败时的错误详情。