---
id: ssh2-firecrawl-search
name: "firecrawl-search"
url: https://skills.yangsir.net/skill/ssh2-firecrawl-search
author: firecrawl
domain: ai-agent-external-interaction
tags: ["web-search", "firecrawl-api", "information-retrieval", "data-discovery", "search-engine-integration"]
install_count: 44200
rating: 4.70 (112 reviews)
github: https://github.com/firecrawl/cli
---

# firecrawl-search

> 执行网页搜索并提取完整页面内容，为数据分析和信息检索提供全面支持，获取深度信息。

**Stats**: 44,200 installs · 4.7/5 (112 reviews)

## Before / After 对比

### 网络搜索与内容提取对比

## Readme

# firecrawl search

Web search with optional content scraping. Returns search results as JSON, optionally with full page content.

## When to use

- You don't have a specific URL yet
- You need to find pages, answer questions, or discover sources
- First step in the [workflow escalation pattern](firecrawl-cli): search → scrape → map → crawl → browser

## Quick start

```bash
# Basic search
firecrawl search "your query" -o .firecrawl/result.json --json

# Search and scrape full page content from results
firecrawl search "your query" --scrape -o .firecrawl/scraped.json --json

# News from the past day
firecrawl search "your query" --sources news --tbs qdr:d -o .firecrawl/news.json --json
```

## Options

| Option                               | Description                                   |
| ------------------------------------ | --------------------------------------------- |
| `--limit <n>`                        | Max number of results                         |
| `--sources <web,images,news>`        | Source types to search                        |
| `--categories <github,research,pdf>` | Filter by category                            |
| `--tbs <qdr:h\|d\|w\|m\|y>`          | Time-based search filter                      |
| `--location`                         | Location for search results                   |
| `--country <code>`                   | Country code for search                       |
| `--scrape`                           | Also scrape full page content for each result |
| `--scrape-formats`                   | Formats when scraping (default: markdown)     |
| `-o, --output <path>`                | Output file path                              |
| `--json`                             | Output as JSON                                |

## Tips

- **`--scrape` fetches full content** — don't re-scrape URLs from search results. This saves credits and avoids redundant fetches.
- Always write results to `.firecrawl/` with `-o` to avoid context window bloat.
- Use `jq` to extract URLs or titles: `jq -r '.data.web[].url' .firecrawl/search.json`
- Naming convention: `.firecrawl/search-{query}.json` or `.firecrawl/search-{query}-scraped.json`

## See also

- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape a specific URL
- [firecrawl-map](../firecrawl-map/SKILL.md) — discover URLs within a site
- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extract from a site


---
*Source: https://skills.yangsir.net/skill/ssh2-firecrawl-search*
*Markdown mirror: https://skills.yangsir.net/api/skill/ssh2-firecrawl-search/markdown*