核心用法
XCrawl Search 是一项调用 XCrawl Search API 的自动化技能，用于执行结构化搜索任务。用户需先在 ~/.xcrawl/config.json 中配置 XCRAWL_API_KEY，随后可通过 cURL 或 Node.js 发送 POST /v1/search 请求。
请求参数包括：
- query（必填）：搜索关键词
- location：地理位置（国家/城市/区域名或 ISO 代码，默认 US）
- language：语言代码（ISO 639-1，默认 en）
- limit：返回结果数量（1-100，默认 10）
响应返回原始 JSON，包含 search_id、status、data 及 total_credits_used 等字段，技能默认不做额外加工。
显著优点
1. 轻量集成：仅需本地配置文件和 curl/node 即可运行，无需复杂环境
2. 灵活可控：支持地理位置和语言参数，便于多区域搜索场景
3. 成本透明：每次调用消耗积分，新用户可领取 1000 免费积分试用
4. 原始输出：保留完整 API 响应，便于下游程序解析
潜在局限
- 需要用户自行注册账号并获取 API Key，无法开箱即用
- 返回数据结构由上游定义，可能存在字段变动风险
- 默认不生成摘要，需用户额外处理原始数据
- 依赖外部 API 稳定性，网络或服务端故障会影响可用性
适合人群
- 开发者需程序化获取搜索结果的场景
- 数据分析师需要原始搜索数据进行二次加工
- 需要多语言/多地区搜索能力的自动化工作流用户
常规风险
- 凭据泄露：API Key 存储于本地明文文件，需注意文件权限管理
- 积分消耗：高频调用可能导致积分快速耗尽，建议设置调用频率限制
- 数据合规：搜索结果可能受版权或地区法规约束，商用需谨慎评估
- 供应商锁定：深度集成后迁移至其他搜索服务需调整接口逻辑