核心用法
xcrawl-scrape 是一款专注于网页数据采集的技能，通过调用 XCrawl 官方 API 实现单页面内容提取。用户需先在本地配置 ~/.xcrawl/config.json 文件写入 API Key，即可通过标准 curl 或 node 工具发起请求。
该技能支持两种执行模式：同步模式（sync） 即时返回结果，适合快速响应场景；异步模式（async） 适用于复杂页面或大规模采集，通过 webhook 或轮询获取结果。输出格式丰富，包括 HTML、Markdown、链接列表、页面摘要、截图以及基于 prompt 或 JSON Schema 的结构化数据提取。
高级功能涵盖：代理配置（支持地理位置指定和会话保持）、请求定制（设备类型、Cookie、Header、TLS 验证跳过）、JS 渲染控制（等待策略、视口设置）以及广告拦截和主内容过滤。
显著优点
1. 零代码依赖：纯 Markdown 文档型设计，无需安装 Python 包或复杂依赖，仅依赖系统标配的 curl 和 node
2. 企业级采集能力：内置浏览器渲染、代理轮换、反爬策略，可处理现代 JavaScript 密集型网站
3. 结构化输出：支持基于自然语言 prompt 或 JSON Schema 的智能提取，直接输出可用数据
4. 成本透明：按 credits 计费，新用户赠送 1000 credits，无订阅压力
5. 隐私优先：API Key 本地存储，不收集用户敏感数据，全链路 HTTPS 加密
潜在缺点与局限性
- 第三方服务依赖：完全依赖 XCrawl 服务可用性，存在单点故障风险
- 成本累积：高频或大规模采集可能快速消耗 credits，需关注用量
- 数据出境：抓取内容需发送至 XCrawl 服务器处理，对数据敏感场景需谨慎评估
- T3 来源风险：个人开发者维护，长期支持和更新频率存在不确定性
- 无本地缓存：每次调用均走网络请求，无法离线复用
适合的目标群体
- 数据分析师：需要快速获取网页表格、文章正文等结构化数据
- 产品经理/运营：竞品监控、价格追踪、舆情收集
- 开发者：构建数据采集管道、自动化测试、内容聚合应用
- 研究人员：学术文献抓取、公开数据集构建
- 无代码用户：通过自然语言描述即可提取数据，无需编写复杂爬虫
使用风险
1. 服务连续性：XCrawl 服务中断或政策变更将直接影响技能可用性
2. 成本控制：异步任务、JS 渲染、高流量页面会显著增加 credits 消耗
3. 数据合规：抓取第三方网站需遵守 robots.txt 和相关法律法规，避免侵权
4. 配置安全：API Key 以明文存储在本地文件，需设置适当文件权限（chmod 600）
5. 网络延迟：同步模式超时风险，复杂页面建议优先使用异步模式
6. Schema 漂移：目标网站结构变更可能导致提取失败，需定期维护提取规则