mcpField
F
firecrawl-interact

firecrawl-interact

github.com/firecrawl生産性1395.7k 回インストール6 日前に更新
リポジトリ

firecrawl-interact について

firecrawl-interact は、ページをスクレイピングした後、ライブブラウザーセッションで操作する CLI スキルです。自然言語やコードで操作でき、プロファイルを使って認証済みのブラウザー状態を再利用できます。

主な機能

  1. 01ページのクリック、フォーム入力、移動
  2. 02特定ページからのデータ抽出
  3. 03プロファイルによるブラウザー状態の再利用
  4. 04複数のスクレイピング済みページの操作

活用シーン

  1. 01ログインフォームを送信してアカウントページを確認
  2. 02ページから価格表を抽出
  3. 03複数のスクレイピング済みページを操作

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/firecrawl/skills --skill firecrawl-interact

インストール後、Claude Code で/firecrawl-interactを入力して読み込まれたか確認します。

詳細

firecrawl interact

ライブブラウザーセッションでスクレイピングしたページを操作します。まずページをスクレイピングし、その後、自然言語のプロンプトやコードを使ってクリック、フォーム入力、ページ移動、データ抽出を行います。ウェブ検索には search を使用してください。interact は特定のページを操作するためのものです。

クイックスタート

# 1. Scrape a page (scrape ID is saved automatically)
firecrawl scrape "<url>"

# 2. Interact with the page using a positional prompt
firecrawl interact "Click the login button"
firecrawl interact "Fill in the email field with [email protected]"
firecrawl interact "Extract the pricing table"

# A UUID first argument is auto-detected as the scrape ID
firecrawl interact "<scrape-id>" "Extract the pricing table"

# 3. Or use code for precise control
firecrawl interact --code "agent-browser click @e5" --bash
firecrawl interact --code "agent-browser snapshot -i" --bash

# 4. Stop the session when done
firecrawl interact stop

すべてのオプションについては、firecrawl interact --help を実行してください。

完了条件： 要求されたコンテンツまたは操作結果が取得され、firecrawl interact stop でセッションが停止していること。

プロファイル

スクレイピング時に --profile を指定すると、ブラウザーの状態（Cookie、localStorage）をスクレイピング間で保持できます。

# Session 1: Login and save state
firecrawl scrape "https://app.example.com/login" --profile my-app
firecrawl interact --prompt "Fill in email with [email protected] and click login"

# Session 2: Come back authenticated
firecrawl scrape "https://app.example.com/dashboard" --profile my-app
firecrawl interact --prompt "Extract the dashboard data"

読み取り専用で再接続します（プロファイルの状態は書き込みません）。

firecrawl scrape "https://app.example.com" --profile my-app --no-save-changes

ヒント

  • 必ず最初にスクレイピングしてください。interact には、以前の firecrawl scrape 呼び出しで取得したスクレイプ ID が必要です
  • スクレイプ ID は自動的に保存されるため、後続の interact 呼び出しでは --scrape-id を省略できます。保存されたセッションは約10分後に期限切れになることがあります。CLI でセッションが古いという警告が表示された場合は、再度スクレイピングしてください
  • 作業が終わったら firecrawl interact stop を使ってリソースを解放してください
  • 並行して作業する場合は、複数のページをスクレイピングし、それぞれに --scrape-id を指定して操作してください

関連項目

  • firecrawl-scrape — まずスクレイピングを試し、必要な場合にのみ interact に切り替えてください
  • firecrawl-search — ウェブ検索には search を使用してください
  • firecrawl-agent — AI を活用した抽出（手動での制御は少なめ）
  • firecrawl-build-interact — ここで実行するのではなく、アプリに interact を組み込む方法

コメント

Markdown 対応