fiverr-mcp-server

Fiverr 用の非公式 MCP サーバー

名称に関するお知らせ： Fiverr International Ltd. から GitHub を通じて、このプロジェクトが公式の Fiverr 製品ではないことを明確にするよう求められました。改めてお伝えします。このプロジェクトは、非公式かつ独立した、コミュニティによって構築されたオープンソースプロジェクトです。Fiverr International Ltd. との提携、同社による推奨や後援はありません。FIVERR は Fiverr International Ltd. の登録商標です。このリポジトリは fiverr-mcp-server から名称を変更しました。PyPI パッケージも名称を変更する場合があり、新しい名称はここにリンクします。

mcp-name: io.github.KyuRish/fiverr-mcp-server

Fiverr のギグ、セラー、価格、レビューを検索・閲覧するための MCP サーバーです。API キーは不要です。

機能

• キーワードとフィルター（価格、セラーレベル、カテゴリー、並べ替え）を指定してギグを検索
• 価格パッケージ（Basic／Standard／Premium）、説明、タグなど、ギグの詳細を取得
• 認定資格、言語、時間単価、ギグの一覧を含むセラープロフィールを表示
• 任意のギグの最初のページにあるギグのレビューを閲覧
• カテゴリーを一覧表示して、フィルター検索に使用できる有効なカテゴリーのスラッグを確認
• すべての価格はUSD（セント単位ではありません）で返されます
• ブラウザーフィンガープリントのローテーション機能を備えた、組み込みのレート制限とリトライ
• 失敗時には、構造化されたエラーメッセージを返します（未処理のクラッシュは発生しません）

インストール

uvx を使用する（推奨）

{
  "mcpServers": {
    "fiverr": {
      "command": "uvx",
      "args": ["fiverr-mcp-server"]
    }
  }
}

pip を使用する

pip install fiverr-mcp-server

ソースからインストールする

git clone https://github.com/KyuRish/mcp-server-for-fiverr-unofficial.git
cd mcp-server-for-fiverr-unofficial
uv sync
uv run fiverr-mcp-server

設定

Claude Desktop の設定（claude_desktop_config.json）に追加します。

• Windows： %APPDATA%\Claude\claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fiverr": {
      "command": "uvx",
      "args": ["fiverr-mcp-server"]
    }
  }
}

環境変数

変数	説明	デフォルト
TRANSPORT	トランスポートモード（stdio または sse）	stdio
PROXY_URL	リクエスト用の任意の HTTP プロキシ	-
RATE_LIMIT_DELAY	リクエスト間の最小秒数	2

利用可能なツール

search_gigs

キーワードで Fiverr マーケットプレイスを検索します。ページネーション情報とともに、1 ページあたり最大 48 件のギグを返します。

パラメーター：

• query（必須） - 検索クエリ（例：「logo design」、「python developer」）
• category - カテゴリーのスラッグ（有効な値は list_categories で確認できます）
• min_price / max_price - USD で指定する価格範囲フィルター
• seller_level - "level_one_seller"、"level_two_seller"、または "top_rated_seller"
• sort_by - "relevance"、"best_selling"、"newest"、"price_asc"、または "price_desc"
• page - ページネーションに使用するページ番号

戻り値： タイトル、価格（USD）、評価、レビュー数、セラー名、URL を含むギグの一覧です。ページネーション用の total_results と has_more も含まれます。

get_gig_details

価格帯のすべてを含む、指定したギグの詳細を取得します。

パラメーター：

• url（必須） - Fiverr のギグ URL またはパス

戻り値： タイトル、説明、セラー情報、パッケージ（名前／価格／納期／修正回数／機能）、タグ、メタデータ、評価、レビュー数、カテゴリー、受注待ち件数です。

get_seller_profile

セラーのプロフィールを取得します。検索結果の seller_name をユーザー名として使用します。

パラメーター：

• username（必須） - セラーの Fiverr ユーザー名

戻り値： 表示名、自己紹介、所在地、登録時期、言語、認定資格、時間単価（USD）、ギグの一覧、認証状況です。

get_gig_reviews

ギグの最初のページにあるレビューを取得します（通常、ページから 5～10 件のレビューが読み込まれます）。

パラメーター：

• url（必須） - Fiverr のギグ URL またはパス

戻り値： 購入者名、国、評価、日付、本文を含むレビューの一覧です。

list_categories

search_gigs で使用できる Fiverr のカテゴリーのスラッグをすべて一覧表示します。

戻り値： slug と name を含むカテゴリーオブジェクトの一覧です。

ワークフローの例

フリーランサーを探す：

1. list_categories() - 利用可能なカテゴリーを確認します
2. search_gigs("3D character modeling") - 検索結果を確認します
3. get_gig_details(url) - 料金プランを確認します（検索結果の URL を使用します）
4. get_seller_profile(seller_name) - プロフィールを確認します（検索結果の seller_name を使用します）
5. get_gig_reviews(url) - レビューを読みます

制限事項

• レビュー - レビューは最初のページのみ利用できます（Fiverr は AJAX 経由で追加のレビューを読み込みますが、認証済みリクエストが必要です）
• レート制限 - Fiverr は短時間にリクエストが集中するとブロックする場合があります。リクエスト間には最低 2 秒の遅延が適用されます（RATE_LIMIT_DELAY で設定可能です）
• データの鮮度 - すべてのデータはキャッシュされず、公開ページからリアルタイムでスクレイピングされます

動作の仕組み

このサーバーは、Fiverr のフロントエンドフレームワークが各ページに埋め込む Perseus SSR データブロブ（<script id="perseus-initial-props">）を読み取り、Fiverr の公開ページから構造化データを抽出します。Cloudflare の保護に対応するため、ブラウザーの TLS フィンガープリントを偽装する curl_cffi を使用し、自動再試行とフィンガープリントのローテーションを行います。

責任ある利用

このツールは、AI アシスタントを通じてフリーランサーを探したり、案件を比較したり、レビューを読んだりする個人利用を目的としています。以下をお守りください。

• 大量のデータ収集や、販売者情報のデータベース構築には使用しないでください
• 大規模な自動競合モニタリングには使用しないでください
• デフォルトのレート制限を維持し、Fiverr のインフラに配慮してください
• ウェブスクレイピングは Fiverr の利用規約に違反する可能性があることにご注意ください

開発

git clone https://github.com/KyuRish/mcp-server-for-fiverr-unofficial.git
cd mcp-server-for-fiverr-unofficial
uv sync
uv run fiverr-mcp-server

ライセンス

MIT