firecrawl-lean について
Firecrawl CLIでウェブ検索や情報抽出を行う人向けの簡潔なリファレンススキルです。検索、スクレイピング、サイトマップ作成から高度なクロールまでを段階的にまとめ、出力管理の指針も示します。
主な機能
- 01ニュースや地域を指定してウェブ検索
- 02複数形式でページをスクレイピング
- 03サイト内のURLを検索
- 04複数ページのクロールやダウンロード
- 05Agentによる構造化データ抽出
活用シーン
- 01特定テーマのウェブページを探す
- 02JavaScript主体のページや長文記事を抽出
- 03ドキュメントサイト内の関連ページを特定
- 04ウェブ情報をローカルファイルやJSONで保存
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ alexsmedile/ firecrawl-lean --skill firecrawl-leanインストール後、Claude Code で/firecrawl-leanを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
.gitignorePROJECT.mdTODO.mdSTATUS.mdLICENSEREADME.md.agents/plugins/marketplace.json.claude-plugin/marketplace.jsonplugin.json.codex-plugin/plugin.jsonarticles/2026-05-19-the-skill-you-load-but-dont-use/article.md詳細
Firecrawl CLI — 簡易リファレンス
ステータス確認: firecrawl --status(認証・クレジット・同時実行数の上限を表示します)。
インストールされていない場合: npm install -g firecrawl-cli && firecrawl auth を実行してください。
認証コマンド: firecrawl login、firecrawl logout、firecrawl view-config
WebFetch と Firecrawl の比較
まず WebFetch を試してください(無料)。Firecrawl は次の場合に使用します:
- Web 検索が必要な場合(WebFetch は検索できません)
- JS を多用する SPA / マーケティングページ
- 記事の全文が必要な場合(WebFetch は長いページを切り捨てます)
- WebFetch の出力が 1000 文字未満、または不完全に見える場合
エスカレーションのパターン
search → scrape → map+scrape → crawl* → interact*
* = 上級、必要に応じて専用スキルをインストールしてください
コマンド
Search — URL がまだなく、ページを探す場合:
firecrawl search "query" --limit 5 -o .firecrawl/results.json --json
firecrawl search "query" --scrape -o .firecrawl/results.json --json # include full content
firecrawl search "query" --sources news --tbs qdr:d --json # news, past day
firecrawl search "query" --country US --location "New York" --json # geo-targeted
Scrape — URL がある場合:
firecrawl scrape "<url>" -o .firecrawl/page.md
firecrawl scrape "<url>" --only-main-content -o .firecrawl/page.md # strip nav/footer
firecrawl scrape "<url>" --wait-for 3000 -o .firecrawl/page.md # wait for JS
firecrawl scrape "<url>" --query "What is the enterprise price?" # targeted Q (5 credits)
firecrawl scrape "<url>" --format markdown,html,screenshot -o .firecrawl/page.md # multi-format
firecrawl scrape "<url>" --format json --schema '{"price":"string"}' -o .firecrawl/data.json # structured
Map — サイト内の URL を探す場合:
firecrawl map "<url>" --search "authentication" -o .firecrawl/urls.txt
firecrawl map "<url>" --limit 200 --json -o .firecrawl/urls.json
firecrawl map "<url>" --include-subdomains --sitemap -o .firecrawl/urls.json
Crawl — サイトのセクションを一括抽出(上級 — 完全なドキュメントについては firecrawl-crawl をインストールしてください):
firecrawl crawl "<url>" --include-paths /docs --limit 50 --wait -o .firecrawl/crawl.json
firecrawl crawl "<url>" --max-depth 3 --delay 500 --exclude-paths /blog --wait -o .firecrawl/crawl.json
Download — サイトをローカルファイルとして保存(上級):
firecrawl download "<url>" --limit 20 -y -o .firecrawl/site/
Interact — スクレイプ後にクリックやフォーム入力を行う(上級 — 完全なドキュメントについては firecrawl-instruct をインストールしてください):
firecrawl scrape "<url>"
firecrawl interact --prompt "Click the login button"
firecrawl interact stop
Agent — AI による構造化抽出(上級 — 完全なドキュメントについては firecrawl-agent をインストールしてください):
firecrawl agent "extract all pricing tiers" --wait -o .firecrawl/data.json
firecrawl agent "extract pricing" --urls "<url>" --schema '{"tiers":[]}' --wait -o .firecrawl/data.json
Browser — CDP/Playwright スタイルの自動化(interact とは異なります):
firecrawl browser launch-session "<url>"
firecrawl browser execute --code "document.querySelector('button').click()"
firecrawl browser list
firecrawl browser close <session-id>
出力のルール
- コンテキストの肥大化を避けるため、常に
-oを付けて.firecrawl/に書き込んでください .firecrawl/を.gitignoreに追加してください- 常に URL を引用符で囲んでください(
?と&はシェルの特殊文字です) - 出力を一度にすべて読まないでください:
head -50 file.mdまたはgrep "keyword" file.md - 命名:
.firecrawl/search-{query}.json、.firecrawl/{site}-{path}.md
JSON 結果から URL を抽出する
jq -r '.data.web[].url' .firecrawl/search.json
クレジット
firecrawl credit-usage