用途
firecrawl-search 用于在没有具体 URL 的情况下进行网络搜索。当你需要查找页面、回答问题、发现资料,尚未拥有明确的目标链接时,这个技能可以作为起点。它是工作流升级模式 search → scrape → map → crawl → interact 的第一步:先搜索,再抓取,再映射,再爬取,最后交互。
主要能力
- 执行网络搜索并返回结果。
- 支持可选的页面内容抓取:使用 --scrape 时,会对每个搜索结果抓取完整页面内容。
- 支持多种搜索来源:web、images、news。
- 支持按类别过滤:github、research、pdf。
- 支持基于时间的搜索过滤:--tbs 可取值 qdr:h、qdr:d、qdr:w、qdr:m、qdr:y。
- 支持指定搜索结果的位置(--location)和国家代码(--country)。
- 结果可以以 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 — 从站点批量提取