firecrawl-alexandria

構造化データへの直接の道筋

Alexandria は、すぐに使えるウェブサイトのワークフロー、API プロバイダー、専門インデックスを Firecrawl の検索とスクレイプに取り込みます。セマンティック検索では、必要なデータに基づいて機能を見つけられます。ドメイン照合では、ウェブ検索結果と、ページを超える豊富な構造化データを取得できるツールを結び付けます。タスクに合ったツールを見つけて構造化された結果を直接取得することで、データを自分で集める際に必要な閲覧、解析、繰り返しのリクエストを減らせます。

• Search でウェブ検索結果と関連ツールを見つけ、タスクに必要な仕様だけを確認します。
• Scrape で選択したツールを実行するか、URL を読み取ります。大量の結果を保持する場合は、リモート Bash のガイダンスを使って必要なデータを選択します。

通常のウェブ検索結果で質問に答えられる場合はそれを使い、カバレッジと入力が適合する場合はプロバイダーツールを使います。

Alexandria へのフィードバック（1 クレジットを返却）

Alexandria のカバレッジは、エージェントからの報告を基に拡大します。データが必要だったウェブサイトごとに firecrawl alexandria feedback を 1 回送信してください。送信するタイミングは、そのウェブサイトに対する最後の Alexandria 呼び出しの直後です。ジョブ ID は不要です。フィードバック 1 回につき 1 クレジットが返却されます。上限は、ウェブサイトごとに 10 クレジット、UTC の 1 日あたりチームごとに 100 クレジットです。

フィードバックでは、次のいずれの結果も報告できます。

• ツールがニーズに完全または部分的に応えた。
• ツールは実行されたが、誤ったデータや不完全なデータが返された、または失敗した。
• そのウェブサイトをカバーするプロバイダーがない、またはプロバイダーはあるものの必要な機能がなく、ウェブ検索、スクレイプ、Agent に切り替えた。

オプトアウト： FIRECRAWL_NO_ENDPOINT_FEEDBACK=1（または FIRECRAWL_DISABLE_ENDPOINT_FEEDBACK=1）が設定されている場合、CLI は呼び出しを通知なしでスキップし、何も送信しません。この設定を尊重し、回避を試みないでください。（チーム管理者はサーバー側でも無効にできます。この場合、API は feedbackErrorCode: "TEAM_OPTED_OUT" を返し、CLI は通知なしで 0 を終了コードとして終了します。）

このコマンドを呼び出す前に確認すべきルール：

• 時間枠： チームが直近で Alexandria の検索、探索、または実行を行ってから20分以内に送信する必要があります。Alexandria を呼び出すたびに時間枠がリセットされます。期限を過ぎたフィードバックは拒否されます（feedbackErrorCode: "FEEDBACK_WINDOW_EXPIRED"）。
• --url はユーザーがデータを必要としていたウェブサイトであり、プロバイダーでも Firecrawl のページでもありません。--requested-functionality には、そのサイトから何を得る必要があったかを1文で記述します。この2つのフィールドが最も重要です。チーム横断で集計され、次に追加すべきサイトやワークフローを判断するために使われます。
• --objective はセッションの根本的な目標です。あなたやユーザーが最終的に何を達成しようとしていたかを1文で記述します（例：「今四半期に入札する連邦政府のIT契約を絞り込む」）。対象がこのウェブサイトだけの--requested-functionalityよりも広い内容です。
• --rationale では、観察した結果に基づいて評価の理由を説明します。 どのプロバイダーや機能がニーズを満たしたか、または満たせなかったか、その理由を記述します。2〜3文にまとめ、結果をそのまま貼り付けないでください。
• --provider-feedback は、対応していない、情報が不十分、または利用できなかったプロバイダーについて、{name, issue, why} の配列を指定する JSON です。問題の種類は次のとおりです：missing_provider（そのサイトに対応するプロバイダーがない）、insufficient_coverage（プロバイダーは存在するが、この市場またはセグメントのデータが乏しい、古い、または不完全）、provider_unavailable（呼び出せなかった）、other。
• --capability-feedback は、存在しない、誤っている、または失敗した機能について、{name, provider, issue, why, requestedFunctionality?} の配列を指定する JSON です。問題の種類は次のとおりです：new_capability_request（プロバイダーに追加を依頼する。requestedFunctionalityが必須）、missing_capability（プロバイダーは存在するが、その機能がない）、insufficient_functionality（機能は存在するが、必要な入力やフィルターに対応できない）、incorrect_result、execution_error、other。nameとproviderには、探索結果に表示された値をそのまま使用してください。まだ存在しない機能については、追加すべき機能の名前を指定してください。
• 正直に評価してください： ツールがニーズを満たした場合はgood、一部を満たした場合や不備があった場合はpartial、利用可能なものでは何も満たせなかった場合、または実行したものが誤っていたり失敗したりした場合はbadです。評価にかかわらず、返金額は同じです。
• ウェブサイトごとの返金上限（UTCの1日あたり。デフォルトは10クレジット）。 上限を超えても、そのウェブサイトに関するフィードバックは記録されますが、返金はされず、レスポンスにwebsiteCapReached: trueが設定されます。他のウェブサイトに関するフィードバックは引き続き返金対象です。
• チームごとの1日あたりの返金上限（UTC。デフォルトは100クレジット）。 上限を超えても、フィードバックは記録されますが、返金はされません。レスポンスにはcreditsRefundedToday、dailyRefundCap、dailyCapReachedが含まれます。dailyCapReached: trueの場合、そのUTC日の残りの時間はAlexandriaにフィードバックを送信しないでください。
• --silent & が適切なパターンです。失敗しても終了コードは0になるため、呼び出しが拒否されてもパイプラインがクラッシュしません。

# Example: send once per website, within 20 minutes of your last Alexandria call. Replace the
# placeholders with what actually happened; drop --provider-feedback or
# --capability-feedback when there is nothing to report at that level.
firecrawl alexandria feedback \
  --rating "<good|partial|bad>" \
  --url "https://sam.gov" \
  --requested-functionality "Active contracts by agency with their attachments" \
  --objective "Shortlist federal IT contracts to bid on this quarter" \
  --rationale "sam-gov/contracts returned the contract list, but no capability exposes attachment links, so those were scraped from the web instead." \
  --capability-feedback '[{"name":"attachments","provider":"sam-gov","issue":"new_capability_request","why":"Attachments were the point of the task","requestedFunctionality":"Given a contract ID, return attachment URLs and document text"}]' \
  --silent &

プロバイダーが対応していないサイトを報告する場合は、--provider-feedback '[{"name":"<site or provider>","issue":"missing_provider","why":"<what was needed>"}]'を使用し、評価をbadにしてください。これは、新しいプロバイダーの導入に使われるシグナルです。

--silentは出力を抑制し、&はバックグラウンドで実行するため、フィードバックによって処理が妨げられることはありません。すべてのオプションを確認するには、firecrawl alexandria feedback --helpを実行してください。