Firecrawl 8mz

🚀 Firecrawl MCP サーバー

FireCrawl MCP（管理コントロールパネル）サーバーは、ウェブクローリング、ログ記録、大規模言語モデル（LLM）生成を統合したソリューションです。コマンドラインインターフェースを通じて、スマートクローラー操作、詳細な調査、標準化されたファイル（llms.txt など）の生成、クレジット監視、エラー処理などの機能を提供します。

🚀 クイックスタート

🔧 設定

環境変数

以下の環境変数を使用してサーバーを設定します。

設定例

# 環境変数の設定
export FIRECRAWL_API_KEY="your_api_key_here"

✨ 主な機能

クローラーフレームワーク（firecrawl_crawler）

ツール名：firecrawl_crawler

説明

指定された URL から深度のあるウェブクローリングを行います。

基本的な使用法

{
  "name": "firecrawl_crawler",
  "arguments": {
    "url": "https://example.com",
    "maxDepth": 3,
    "outputFormat": "json"
  }
}

パラメータ

• url (文字列、必須)：クローリングの開始 URL です。
• maxDepth (数値、任意)：クローリングの最大深度です。デフォルトは 2 です。
• outputFormat (文字列、任意)：出力形式です。"json" または "xml" を選択できます。

高度な使用法

{
  "content": [
    {
      "type": "text",
      "text": "成功爬取 URL: https://example.com"
    }
  ],
  "isError": false
}

ログシステム

説明

操作状態、パフォーマンス指標、クレジット使用状況、レート制限、エラー条件など、包括的なログ記録機能を提供します。

ログメッセージ例

[INFO] FireCrawl MCP Server 已成功初始化
[INFO] 正在爬取 URL: https://example.com
[WARNING] 信用使用量已达到警告阈值
[ERROR] 速率限制已超过，2 秒后重试...

エラー処理

説明

自動リトライ、レート制限処理、詳細なエラーメッセージ、クレジット使用警告、ネットワークの弾力性など、強力なエラー処理機能を提供します。

エラー応答例

{
  "content": [
    {
      "type": "text",
      "text": "请求的参数无效"
    }
  ],
  "isError": true,
  "errorDetails": "参数格式不正确"
}

📦 インストール

依存関係のインストール

以下のコマンドを使用して必要な依存関係をインストールします。

pip install -r requirements.txt

サーバーの起動

サーバーを起動する前に、FIRECRAWL_API_KEY 環境変数を設定してください。その後、以下のコマンドを実行します。

python server.py

🤝 貢献ガイド

コードの提出

コードを提出するには、以下の手順に従ってください。

1. 機能ブランチを作成します。
2. 変更をコミットします。
3. main ブランチにプルリクエストを提出します。

規約の遵守

• PEP8 コードスタイルガイドに従ってください。
• すべての新機能に対してユニットテストを実施してください。
• コミット前にコードの品質を確認してください。

🙏 謝辞

以下の貢献者に感謝します。

• [Contributor Name] - 初期開発
• [Contributor Name] - 機能拡張

📄 ライセンス

MIT License

Copyright (c) [Year] [Author Name]

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.