firecrawl-cli

جست‌وجوی وب با استخراج محتوای کامل صفحات و خروجی JSON قابل‌پردازش

این skill با استفاده از Firecrawl در وب جست‌وجو می‌کند و در صورت نیاز، محتوای کامل صفحات نتایج را استخراج می‌کند. برای پیدا کردن منابع، مقاله‌ها، اخبار و اطلاعاتی که URL آن‌ها را نمی‌دانید مناسب است.

نتایج به‌صورت JSON در پوشه .firecrawl/ ذخیره می‌شوند تا بتوانید آن‌ها را با ابزارهایی مثل jq پردازش کنید. امکان جست‌وجوی اخبار، دریافت highlights مرتبط و ارسال feedback برای بهبود کیفیت نتایج نیز فراهم است.

چه چیزی می‌گیرید

  • جست‌وجوی وب با خروجی JSON ساخت‌یافته
  • استخراج محتوای کامل صفحات نتایج با گزینه `--scrape`
  • فیلتر نتایج خبری و جست‌وجو در بازه‌های زمانی مشخص
  • ذخیره‌سازی منظم نتایج در پوشه `.firecrawl/`
  • ارسال feedback پس از استفاده از نتایج، مگر در صورت غیرفعال‌بودن آن

برای چه کاری خوب است

  • پیدا کردن منابع معتبر، مقاله‌ها یا اخبار درباره یک موضوع ناشناخته
  • جمع‌آوری محتوای چند صفحه برای خلاصه‌سازی یا تحلیل بیشتر
  • ساخت workflowهای تحقیقاتی که به خروجی JSON و URLهای قابل‌پردازش نیاز دارند

برای چه کاری نیست

  • پرسش‌های تخصصی درباره API، خطاها یا کتابخانه‌ها که به `firecrawl-developer-index` نیاز دارند
  • جست‌وجوی مقاله‌های علمی که باید با `firecrawl-research-index` انجام شود
  • زمانی که URL دقیق صفحه را دارید و فقط به scrape مستقیم همان URL نیاز دارید

دربارهٔ این اسکیل

skills/firecrawl-search/SKILL.md

skills/firecrawl-search/SKILL.md

  • Branch: main
  • Repository: firecrawl/cli

name: firecrawl-search
description: |
Web search with full page content. Use when no URL is known: finding sources, articles, or news. For papers use firecrawl-research-index; for library, API, error, or bug questions use firecrawl-developer-index.
allowed-tools:

  • Bash(firecrawl *)
  • Bash(npx firecrawl-cli *)

firecrawl search

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

Quick start

# 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

Run firecrawl search --help for the full option list.

--categories developer weighs the developer index beside ordinary web results in this same call (no passage control, no index filters). --categories research is a website filter, not the paper index. Dedicated skills: firecrawl-developer-index and firecrawl-research-index.

Done when: results are saved under .firecrawl/, verified non-empty, processed for the request, and one feedback event is sent within the time window (unless opted out).

Tips

  • --highlights on by default: results are query-relevant excerpts, not full-page snippets. Use --no-highlights for the original snippets.
  • --scrape fetches full content — reuse that content instead of re-scraping result URLs. 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

Send feedback after every search (refunds 1 credit)

Search costs 2 credits. After you've actually used the results (or decided they were useless), send structured feedback with firecrawl search-feedback . The first feedback per search refunds 1 credit and helps us improve search quality. Do this once per search, in the background, after you finish processing the results — it does not block your main task.

Opt out: if FIRECRAWL_NO_SEARCH_FEEDBACK=1 (or FIRECRAWL_DISABLE_SEARCH_FEEDBACK=1) is set, the CLI silently skips the call and never sends anything. Respect that — do not try to work around it. (Team admins can also disable this server-side; the API will return feedbackErrorCode: "TEAM_OPTED_OUT" and the CLI will exit 0 silently.)

Rules to know before you call this:

  • Time window: must be sent within ~2 minutes of the search. Late feedback is rejected.
  • --missing-content is the most important field. It's a list of _specific pieces_ of content you expected but did not find. One topi

دانلود ZIP