firecrawl/cli

Firecrawl CLI and agent skills: web search, scraping, crawling and browser interaction from your terminal or any coding agent. Firecrawl is the most complete web data API for AI agents.

🔥 Firecrawl CLI – とは

Firecrawl CLI は、ターミナルから直接 Firecrawl プラットフォームを操作できるコマンドラインツールです。Firecrawl は、AI 駆動型の Web スクレイピング、検索、および研究サービスであり、以下のことが可能です:

  • Webページのクロールとスクレイピング(JavaScript でレンダリングされたサイトを含む)
  • ハイライト付きスニペットを用いた Web 検索
  • 特化された開発者コードインデックスおよび膨大な研究論文インデックスのクエリ
  • SEO 監査、リードリスト生成、ナレッジベース作成などの高レベルな「エージェントジョブ」の実行

この CLI は、これらすべての機能をシンプルなコマンド(scrape、search、developer、research など)にまとめ、サポートされている AI コーディングエージェント(Claude Code、Cursor、OpenHands など)に Firecrawl を自動的に使用させるためのスキルをインストールできます。


クイックスタートとインストール

# npm を使用したグローバルインストール
npm install -g firecrawl-cli

# CLI のインストール、ログイン、および検出された AI コーディングエディタへのスキル登録を一度に行うコマンド
npx -y firecrawl-cli@latest init -y --browser
  • -y – 非対話形式でセットアップを実行します。
  • --browser – OAuth ログイン用のブラウザウィンドウを開きます。
  • スキルは、--agent でスコープを指定しない限り、検出されたすべての「ハーネス」(Claude Code、Cursor など)に自動的に追加されます。

コアコマンド

コマンド 機能 一般的なオプション
scrape <url> ページからコンテンツを取得します。デフォルトでは Markdown ですが、生の HTML、JSON、画像、スクリーンショット、または AI 生成の要約を出力することも可能です。 --format <list>, --html, --summary, --only-main-content, --screenshot, --output <file>
search "query" Web 検索(Google スタイル)を実行します。オプションでハイライトを付けたり、取得したページを一度にスクレイピングしたりできます。 --limit, `--sources web
developer "query" Developer Index を検索します。公開リポジトリ、GitHub issues、PR、README、ドキュメントの厳選されたコレクションです。プログラミングに関する質問への回答に最適です。 --limit, --json, --pretty
research … Research Paper Index(約 4300 万件の要約、主に生物医学と arXiv)をクエリします。セマンティック検索、論文の調査、引用グラフの展開、特定の箇所の読み取りをサポートしています。 サブコマンド: search-papers, inspect-paper, related-papers, read-paper, search-github
login OAuth ログイン用のブラウザを開くか、--api-key 経由で API キーを受け入れます。
setup … AI コーディングエージェントにスキル(CLI プリミティブ、ビルド SDK ヘルパー、ワークフローレシピ)をインストールするか、エディタ内の MCP (Multi-Client Provider) サーバーを設定します。

スキルとエージェントの統合

Firecrawl は、AI コーディングエージェントに以下の方法を教える スキル (firecrawl/skills) のカタログを提供しています:

  • ライブ Web 作業に CLI を使用する。
  • すぐに使える成果物(SEO 監査、リードリスト、研究概要など)を作成する。

一括インストール:

firecrawl setup core      # 基本的なスクレイピング/検索/クロールプリミティブ
firecrawl setup build    # SDK スタイルの統合ヘルパー
firecrawl setup workflows# エンドツーエンドのレシピ

特定のハーネスをターゲットにする場合:

firecrawl setup core --agent codex

setup defaults コマンドを使用すると、Firecrawl を特定のエージェントのデフォルト Web プロバイダーにし、エージェントのネイティブな fetch 実装を上書きできます。


認証とセルフホスト

  • 初回実行時にログイン(ブラウザまたは手動 API キー)が求められます。
  • 環境変数 FIRECRAWL_API_KEY を設定することも可能です。
  • セルフホストインスタンスの場合は、--api-url <url>(または FIRECRAWL_API_URL)を指定します。カスタム URL を使用すると、CLI は認証をスキップし、キーなしでローカル開発が可能になります。

ワークフローの例

  1. Markdown へのワンオフスクレイピング
    firecrawl https://example.com -o page.md
    
  2. 検索し、上位 5 件の結果を JSON として自動スクレイピング
    firecrawl search "AI agents" --scrape --scrape-formats markdown,links --json -o results.json
    
  3. CRISPR に関する生物医学論文を探し、特定の主張を読む
    firecrawl research search-papers "CRISPR base editing" --limit 10
    firecrawl research read-paper doi:10.1016/j.neunet.2025.108095 \
        --question "What was the sample size?"
    
  4. Cursor エディタのみに Firecrawl スキルを追加
    firecrawl init --agent cursor
    firecrawl setup skills --agent cursor
    

ターゲットユーザー

  • 開発者: 独自のクローラーを書かずに、信頼性の高い Web スクレイピングや検索が必要なアプリケーションを構築している方。
  • AI エージェント (Claude Code, Cursor, OpenHands など): ライブ Web データを取得するためのプラグインを必要としている方。
  • 研究者: 数百万件の論文要約に素早くセマンティックにアクセスしたい方。
  • プロダクトチーム: SEO 監査、リード生成、ナレッジベース作成をワークフロースキルで自動化したい方。

まとめ

Firecrawl CLI は、強力な AI 駆動型 Web データサービスを包む、ターミナルフレンドリーな薄いラッパーです。認証を処理し、豊富な出力形式を提供し、再利用可能な「スキル」で AI コーディングエージェントを拡張できるため、エージェントはカスタムコードなしでライブ Web コンテンツを取得、スクレイピング、推論できます。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト