SuperAPI AI 工具集

firecrawl-search

通用与其它

查看项目

更新于 10-16 16:28

技能介绍

用途

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 — 从站点批量提取