用途
firecrawl-search 用于 Web 搜索，并可选择性地抓取页面内容。当用户尚未拥有具体 URL，需要查找网页、寻找文章、研究某个主题或发现来源时使用该技能。它是工作流升级模式「搜索 → 抓取 → 映射 → 爬取 → 交互」中的第一步。
主要能力
- 返回 JSON 格式的搜索结果。
- 可选地为每个搜索结果附带完整页面内容（抓取）。
- 支持按来源类型、类别、时间、位置和国家进行过滤。
使用方式
快速开始示例：
基本搜索：
firecrawl search "your query" -o .firecrawl/result.json --json
搜索并抓取结果页面的完整内容：
firecrawl search "your query" --scrape -o .firecrawl/scraped.json --json
过去一天的新闻：
firecrawl search "your query" --sources news --tbs qdr:d -o .firecrawl/news.json --json
可用选项：
| 选项 | 说明 |
|---|---|
--limit <n> |
最大结果数量 |
--sources <web,images,news> |
要搜索的来源类型 |
--categories <github,research,pdf> |
按类别过滤 |
--tbs <qdr:h|d|w|m|y> |
基于时间的搜索过滤 |
--location |
搜索结果的位置 |
--country <code> |
搜索的国家代码 |
--scrape |
同时抓取每个结果的完整页面内容 |
--scrape-formats |
抓取时的格式（默认：markdown） |
-o, --output <path> |
输出文件路径 |
--json |
以 JSON 输出 |
适用场景与提示
--scrape会获取完整内容——不要重复抓取搜索结果中的 URL，这可节省额度并避免冗余抓取。- 始终使用
-o将结果写入.firecrawl/，以避免上下文窗口膨胀。 - 可使用
jq提取 URL 或标题，例如：jq -r '.data.web[].url' .firecrawl/search.json。 - 命名约定：
.firecrawl/search-{query}.json或.firecrawl/search-{query}-scraped.json。
相关技能
- firecrawl-scrape：抓取特定 URL
- firecrawl-map：发现站点内的 URL
- firecrawl-crawl：从站点批量提取