pp-firecrawl

Firecrawl — Printing Press CLI

前提条件：CLI のインストール

このスキルは firecrawl-pp-cli バイナリを使用します。このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。 インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。デフォルトでは、macOS/Linux では $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

   npx -y @mvanhorn/printing-press-library install firecrawl --cli-only
   

2. 確認します：firecrawl-pp-cli --version
3. 報告されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go から直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/developer-tools/firecrawl/cmd/firecrawl-pp-cli@latest

インストール後に --version が「command not found」を報告する場合、ランタイムからバイナリディレクトリを $PATH 経由で参照できません。確認に成功するまでは、スキルのコマンドを実行しないでください。

コマンドリファレンス

batch — バッチを管理します

• firecrawl-pp-cli batch cancel-scrape — バッチスクレイプジョブをキャンセルします
• firecrawl-pp-cli batch get-scrape-errors — バッチスクレイプジョブのエラーを取得します
• firecrawl-pp-cli batch get-scrape-status — バッチスクレイプジョブのステータスを取得します
• firecrawl-pp-cli batch scrape-and-extract-from-urls — 複数の URL をスクレイプし、任意で LLM を使用して情報を抽出します

crawl — クロールを管理します

• firecrawl-pp-cli crawl cancel — クロールジョブをキャンセルします
• firecrawl-pp-cli crawl get-active — 認証済みチームのアクティブなクロールをすべて取得します
• firecrawl-pp-cli crawl get-status — クロールジョブのステータスを取得します
• firecrawl-pp-cli crawl urls — オプションに基づいて複数の URL をクロールします

deep-research — ディープリサーチを管理します

• firecrawl-pp-cli deep-research get-status — ディープリサーチ操作のステータスと結果を取得します
• firecrawl-pp-cli deep-research start — クエリに対するディープリサーチ操作を開始します

extract — 抽出を管理します

• firecrawl-pp-cli extract data — LLM を使用してページから構造化データを抽出します
• firecrawl-pp-cli extract get-status — 抽出ジョブのステータスを取得します

firecrawl-search — Firecrawl 検索を管理します

• firecrawl-pp-cli firecrawl-search — 検索し、任意で検索結果をスクレイプします

llmstxt — llmstxt を管理します

• firecrawl-pp-cli llmstxt generate-llms-txt — ウェブサイト用の LLMs.txt を生成します
• firecrawl-pp-cli llmstxt get-llms-txt-status — LLMs.txt 生成ジョブのステータスと結果を取得します

map — マップを管理します

• firecrawl-pp-cli map — オプションに基づいて複数の URL をマップします

scrape — スクレイプを管理します

• firecrawl-pp-cli scrape — 単一の URL をスクレイプし、任意で LLM を使用して情報を抽出します

team — チームを管理します

• firecrawl-pp-cli team get-credit-usage — 認証済みチームの残りのクレジット数を取得します
• firecrawl-pp-cli team get-token-usage — 認証済みチームの残りのトークン数を取得します（Extract のみ）

適切なコマンドを見つける

実行したいことはわかっていても、どのコマンドを使えばよいかわからない場合は、CLI に直接問い合わせてください。

firecrawl-pp-cli which "<capability in your own words>"

which は自然言語での機能クエリを、この CLI の厳選された機能インデックスから最適なコマンドに対応付けます。終了コード 0 は少なくとも 1 つの候補が見つかったことを示します。終了コード 2 は確度の高い候補が見つからなかったことを示します。その場合は --help を使うか、より絞り込んだクエリを指定してください。

認証の設定

アクセストークンを保存します。

firecrawl-pp-cli auth set-token YOUR_TOKEN_HERE

または、環境変数として FIRECRAWL_BEARER_AUTH を設定します。

firecrawl-pp-cli doctor を実行して設定を確認します。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON を出力し、エラーは stderr に出力します

• フィルタ可能 — --select でフィールドを絞り込みます。ドット区切りのパスはネストされた構造をたどり、配列では各要素を順に処理します。出力が冗長な API でコンテキストを小さく保つうえで重要です。

  firecrawl-pp-cli batch cancel-scrape mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run で、送信せずにリクエストを表示します

• オフラインでも利用可能 — 同期／検索コマンドは、利用可能な場合、ローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を出所情報エンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を、ライブデータかローカルデータかの判別には .meta.source を解析してください。人が読みやすい N results (live) の概要は、標準出力がターミナルの場合にのみ標準エラーへ出力されます。パイプやエージェントによる利用時は、標準出力に純粋な JSON のみが出力されます。

エージェントからのフィードバック

この CLI について気になる点に気づいたら（エージェントが気づいた場合も）、記録してください。

firecrawl-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
firecrawl-pp-cli feedback --stdin < notes.txt
firecrawl-pp-cli feedback list --json --limit 10

記録はローカルの ~/.firecrawl-pp-cli/feedback.jsonl に保存されます。FIRECRAWL_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか、FIRECRAWL_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカルのみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で記録してください。積み重ねにつながるのは、そうした記録です。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。エージェントがコマンド結果を手動でパイプすることなく振り分けられるよう、出力は標準出力に加えて（または標準出力の代わりに）指定したシンクへ送られます。サポートされているシンクは 3 種類です。

シンク	効果
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、サポートされているスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、URL と HTTP ステータスが標準エラーに記録されます。

名前付きプロファイル

プロファイルは、保存して再利用できるフラグ値のセットです。スケジュールされたエージェントが毎回同じ設定で同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

firecrawl-pp-cli profile save briefing --json
firecrawl-pp-cli --profile briefing batch cancel-scrape mock-value
firecrawl-pp-cli profile list --json
firecrawl-pp-cli profile show briefing
firecrawl-pp-cli profile delete briefing --yes

明示的なフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルトより優先されます。agent-context は available_profiles に利用可能なすべてのプロファイルを一覧表示するため、情報を調べるエージェントは実行時にプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法エラー（引数が正しくありません）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限。待ってから再試行してください
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → firecrawl-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール。それ以外の場合は、上記の前提条件を参照してください
3. その他すべて → 直接使用（--agent を指定して CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/other/firecrawl-pp-cli/cmd/firecrawl-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add firecrawl-pp-mcp -- firecrawl-pp-mcp
   

3. 検証します。claude mcp list

直接使用

1. インストール済みか確認します。which firecrawl-pp-cli 見つからない場合は、インストールを提案してください（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の独自機能とコマンドリファレンスから選びます。
3. --agent フラグを指定して実行します。

   firecrawl-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認してください。firecrawl-pp-cli <command> --help