Tomba MCP Server

公式

Tombaは、ユニークなB2Bメールファインダーおよび検証ツールであり、リーチを簡単かつ効果的に拡大するための独自のリードデータベースを提供します。

GitHub

ドキュメント

Tomba.io MCP サーバー

Tomba.io API と統合するためのモデルコンテキストプロトコル (MCP) サーバーです。このサーバーは、標準化された MCP インターフェースを通じて、包括的なメール検出、検証、およびエンリッチメント機能を提供します。

機能

ツール (12 個利用可能)

ドメイン検索: ドメインに関連付けられたすべてのメールアドレスを検索します
メール検索: 名前とドメインから可能性の高いメールアドレスを生成します
メール検証: メールの到達可能性を検証し、データベースの存在を確認します
メールエンリッチメント: 追加の連絡先データでメールを強化します
著者検索: 記事の著者のメールアドレスを検出します
LinkedIn 検索: LinkedIn プロフィール URL からメールを検索します
電話番号検索: メール、ドメイン、または LinkedIn で電話番号を検索します
電話番号検証: 電話番号を検証し、キャリア情報を確認します
メール件数: ドメインの総メール件数を取得します
類似検索: ターゲットドメインに基づいて類似ドメインを検索します
テクノロジー検索: Web サイトで使用されているテクノロジースタックを検出します
企業検索: 自然言語クエリと高度なフィルターを使用して企業を検索します

リソース (7 個利用可能)

tomba://api/status - API ステータスとアカウント情報
tomba://domain/{domain} - ドメイン情報
tomba://email/{email} - メール情報
tomba://similar/{domain} - 類似ドメイン分析
tomba://technology/{domain} - テクノロジースタック情報
tomba://docs/api - API ドキュメント
tomba://docs/tools - ツールドキュメント

プロンプト (16 個の事前構築ワークフロー)

find_contact - 個人の完全な連絡先情報を検索します
verify_email_list - メールアドレスを一括検証します
research_company - 企業の連絡先と構造を調査します
enrich_lead - 利用可能なすべてのデータでリードを強化します
find_journalists - 記事からジャーナリストの連絡先を検索します
finder_phone - 連絡先の電話番号を検索します
validate_phone - 電話番号を検証します
competitor_analysis - 類似ドメインとテクノロジーを使用して競合他社を分析します
technology_audit - Web サイトの包括的なテクノロジー監査
domain_insights - メール件数やテクノロジーを含むドメインに関する包括的なインサイトを取得します
bulk_domain_research - 複数のドメインのメール件数と基本情報を調査します
find_target_companies - 高度なフィルター (規模、種類、収益、業界) で企業を検索します
market_research - 包括的なフィルタリングで市場セグメントの企業を調査します
lead_generation - 企業とその連絡先を検索してリードを生成します
prospect_enrichment - 包括的なデータで企業見込み客を強化します
industry_analysis - 詳細なセグメンテーションで業界内の企業を分析します

企業検索プロンプトのフィルターオプション

フィルター	利用可能な値
規模	1-10 (マイクロ), 11-50 (小規模), 51-250 (中規模), 251-1K (中～大規模), 1K-5K (大規模), 5K-10K (非常に大規模), 10K-50K (エンタープライズ), 50K-100K (巨大), 100K+ (グローバル)
種類	education, government, nonprofit, private, public, personal
収益	$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
業界	LinkedIn Industry Codes V2 に基づく (コンピューターソフトウェア、金融サービス、病院・ヘルスケアなど 140 以上の業界)

トランスポートオプション

stdio - 標準入出力 (デフォルト、Claude Desktop 用)
http - REST エンドポイントを持つ HTTP サーバー

インストール

前提条件

Node.js 18 以上
npm または yarn
Tomba API アカウント (こちらからサインアップ)

スクリーンショット

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

オプション 1: NPX 経由でインストール (推奨)

Tomba MCP サーバーを使用する最も簡単な方法は npx 経由です。リポジトリのクローンは不要です。

macOS/Linux

claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json) に追加します:

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows

claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json) に追加します:

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

注: -y フラグはインストールプロンプトを自動的に受け入れ、npx は常に最新バージョンを取得します。

オプション 2: ソースからインストール

サーバーを変更したり、開発に貢献したい場合:

# Clone the repository
git clone https://github.com/tomba-io/tomba-mcp-server.git
cd tomba-mcp-server

# Install dependencies
yarn install

# Build the project
yarn build

設定

OpenClaw スキル

このリポジトリには、skills/tomba-contact-intelligence/SKILL.md にワークスペースローカルの OpenClaw スキルが含まれています。

このスキルは、OpenClaw が連絡先検出、企業調査、メール検証、電話番号検索、見込み客エンリッチメントのワークフローに適切な Tomba MCP ツールを選択できるように設計されています。

使用するには:

このリポジトリを OpenClaw ワークスペースとして開くか、skills/tomba-contact-intelligence ディレクトリを OpenClaw スキルディレクトリにコピーします。
Tomba MCP サーバーが設定され、OpenClaw で利用可能であることを確認します。
新しい OpenClaw セッションを開始して、スキルを読み込みます。

プロンプトの例:

"stripe.com のパートナーシップ担当に最適な連絡先を見つけ、返信する前にメールを検証してください。"
"ドイツのフィンテック企業を調査し、上位の一致企業の営業担当候補を特定してください。"
"この見込み客をメール、電話、企業テクノロジー、類似競合他社で強化してください: [email protected]"

Claude Desktop セットアップ

このサーバーを Claude Desktop で使用するには、claude_desktop_config.json ファイルに設定を追加します。

NPX を使用する場合 (推奨)

この方法では、公開されている最新バージョンが自動的に使用されます。

macOS/Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

ローカルインストールを使用する場合

ソースからビルドした場合は、インストールへの絶対パスを使用します。

macOS/Linux:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "C:\\ABSOLUTE\\PATH\\TO\\tomba-mcp-server\\server\\index.js"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

重要な注意事項:

your-api-key-here と your-secret-key-here を実際の Tomba API 認証情報に置き換えてください
ローカルインストールの場合、/ABSOLUTE/PATH/TO/tomba-mcp-server をインストールディレクトリへのフルパスに置き換えてください
設定を更新した後、Claude Desktop を再起動してください

Tomba API 認証情報の取得

https://tomba.io にアクセスします
アカウントにサインアップするか、ログインします
ダッシュボードに移動します
API 設定に移動します
API キーとシークレットキーをコピーします

代替手段: HTTP トランスポートの使用

npx を使用した HTTP トランスポートの場合:

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": [
                "-y",
                "tomba-mcp-server",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

ローカルインストールを使用した HTTP トランスポートの場合:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

使用方法

コマンドラインオプション

Usage: tomba-mcp-server [options]

Options:
  --transport <type>    Transport type: 'stdio' or 'http' (default: stdio)
  --port <number>       Port number for HTTP transport (default: 3000)
  --help                Show help message

Environment Variables:
  TOMBA_API_KEY         Your Tomba API key (required)
  TOMBA_SECRET_KEY      Your Tomba secret key (required)

Examples:
  # Run with stdio transport (default)
  node server/index.js

  # Run with HTTP transport on default port (3000)
  node server/index.js --transport http

  # Run with HTTP transport on custom port
  node server/index.js --transport http --port 8080

スタンドアロン HTTP サーバー

サーバーをスタンドアロン HTTP サービスとして実行することもできます。

export TOMBA_API_KEY="your-api-key"
export TOMBA_SECRET_KEY="your-secret-key"
node server/index.js --transport http --port 3000

HTTP API エンドポイント

POST /mcp - JSON-RPC リクエストを送信します
GET /mcp - 通知用のサーバー送信イベント (X-Session-Id ヘッダーが必要)
DELETE /mcp - セッションを終了します (X-Session-Id ヘッダーが必要)
GET /health - ヘルスチェックエンドポイント
GET /sessions - アクティブなセッションを一覧表示します (認証が必要)

HTTP リクエストの例

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "email_finder",
      "arguments": {
        "domain": "stripe.com",
        "firstName": "Patrick",
        "lastName": "Collison"
      }
    },
    "id": 1
  }'

🔧 開発

開発コマンド

# Run in development mode
yarn dev

# Build the project
yarn build

# Run tests
yarn test

# Run tests in watch mode
yarn test:watch

# Run tests with coverage
yarn test:coverage

# Lint code
yarn lint

# Fix linting errors
yarn lint:fix

🔍 デバッグとテスト

MCP Inspector (推奨)

MCP サーバーをテストおよびデバッグする最も簡単な方法です。

# Build and launch MCP Inspector
yarn debug

これにより Web インターフェースが開き、次のことが可能になります。

📋 利用可能なすべてのツールを表示
🧪 ツールをインタラクティブにテスト
📊 リクエスト/レスポンスを検査
🐛 リアルタイムでデバッグ

代替デバッグ方法

# Debug TypeScript directly
yarn debug:dev

# Run integration tests
yarn test:integration

# Manual testing
yarn build
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node server/index.js

VS Code デバッグ

VS Code を使用している場合は、含まれているデバッグ構成を使用します。

Debug MCP Server: コンパイルされた JavaScript をデバッグします
Debug TypeScript: TypeScript ソースを直接デバッグします
Debug with Inspector: MCP Inspector でデバッグします
Run Tests: Jest テストをデバッグします

包括的なデバッグ手順については、DEBUG_GUIDE.md を参照してください。

🧪 個別ツールのテスト

1. ドメイン検索

ドメイン名に関連付けられたメールアドレスを検索します。

{
    "name": "domain_search",
    "arguments": {
        "domain": "tomba.io",
        "limit": 10,
        "page": 1
    }
}

レスポンス:

{
  "data": {
    "organization": {
      "website_url": "tomba.io",
      "organization": "Tomba technology web service LLC",
      "location": {
        "country": "US",
        "city": "Claymont",
        "state": "Delaware",
        "street_address": "1228 claymont",
        "postal_code": "19703"
      },
      "social_links": {
        "twitter_url": "https://twitter.com/tombaplatforum",
        "facebook_url": "https://www.facebook.com/tombaplatforum",
        "linkedin_url": "https://www.linkedin.com/company/tomba-io"
      },
      "disposable": false,
      "webmail": false,
      "phone_number": "(850) 790-5575",
      "industries": "Information Technology and Services",
      "founded": "2021",
      "company_size": "1-10",
      "company_type": "privately held",
      "revenue": "$0-$1M",
      "accept_all": false,
      "description": "the most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.",
      "pattern": "{l}.{first}",
      "total_similar": 35,
      "keywords": [
        "lead generation software"
      ],
      "ranking": 661495,
      "whois": {
        "registrar_name": "namecheap, inc.",
        "created_date": "2020-07-07T20:54:07+02:00",
        "referral_url": "https://www.namecheap.com/"
      },
      "last_updated": "2025-09-06T00:22:01+02:00"
    },
    "emails": [
      {
        "email": "[email protected]",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "DZ",
        "position": "CEO",
        "department": "executive",
        "seniority": "senior",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "verification": {
          "date": "2025-09-22T00:00:00+02:00",
          "status": "valid"
        },
        "sources": [
          {
            "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
            "website_url": "github.com",
            "extracted_on": "2021-02-08T20:09:54+01:00",
            "last_seen_on": "2021-02-08T22:43:40+01:00",
            "still_on_page": true
          },
          ....
        ]
      },
      ...
      ...
      ...
      ...
      ...
    ]
  },
  "meta": {
    "total": 21,
    "pageSize": 10,
    "current": 1,
    "total_pages": 3,
    "params": {
      "domain": "tomba.io",
      "page": 1,
      "limit": 10,
      "department": null,
      "country": null,
      "type": "all",
      "live": false
    }
  }
}

2. メール検索

ドメイン、名、姓から可能性の高いメールアドレスを生成します。

{
    "name": "email_finder",
    "arguments": {
        "domain": "example.com",
        "firstName": "John",
        "lastName": "Doe"
    }
}

レスポンス:

{
    "data": {
        "email": "[email protected]",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

3. メール検証

メールアドレスの到達可能性を検証し、データベースの存在を確認します。

{
    "name": "email_verifier",
    "arguments": {
        "email": "[email protected]"
    }
}

レスポンス:

{
    "data": {
        "email": {
            "email": "[email protected]",
            "result": "deliverable",
            "status": "valid",
            "score": 99,
            "smtp_provider": "Google Workspace",
            "mx": {
                "records": [
                    "aspmx.l.google.com",
                    "alt2.aspmx.l.google.com",
                    "alt1.aspmx.l.google.com",
                    "alt4.aspmx.l.google.com",
                    "alt3.aspmx.l.google.com"
                ]
            },
            "mx_check": true,
            "smtp_server": true,
            "smtp_check": true,
            "accept_all": false,
            "greylisted": false,
            "block": true,
            "gibberish": false,
            "disposable": false,
            "webmail": false,
            "regex": true,
            "whois": {
                "registrar_name": "namecheap, inc.",
                "referral_url": "https://www.namecheap.com/",
                "created_date": "2020-07-07T20:54:07+02:00"
            }
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

4. メールエンリッチメント

追加の連絡先情報でメールアドレスを強化します。

{
    "name": "email_enrichment",
    "arguments": {
        "email": "[email protected]"
    }
}

レスポンス:

{
    "data": {
        "email": "[email protected]",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

5. 著者検索

URL から記事の著者のメールアドレスを検索します。

{
    "name": "author_finder",
    "arguments": {
        "url": "https://example.com/article"
    }
}

レスポンス:

{
    "data": {
        "email": "[email protected]",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

6. LinkedIn 検索

LinkedIn プロフィール URL からメールアドレスを検索します。

{
    "name": "linkedin_finder",
    "arguments": {
        "url": "https://linkedin.com/in/johndoe"
    }
}

レスポンス:

{
    "data": {
        "email": "[email protected]",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

7. 電話番号検索

メール、ドメイン、または LinkedIn プロフィールに基づいて電話番号を検索します。

{
    "name": "phone_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

レスポンス:

{
    "data": {
        "domain": "tomba.io",
        "valid": true,
        "local_format": "(850) 790-5575",
        "intl_format": "+1 850-790-5575",
        "e164_format": "+18507905575",
        "rfc3966_format": "tel:+1-850-790-5575",
        "country_code": "US",
        "line_type": "FIXED_LINE_OR_MOBILE",
        "carrier": "",
        "timezones": ["America/New_York"]
    }
}

8. 電話番号検証

電話番号を検証し、キャリア情報を確認します。

{
    "name": "phone_validator",
    "arguments": {
        "phone": "+213667945402"
    }
}

レスポンス:

{
    "data": {
        "valid": true,
        "local_format": "0667 94 54 02",
        "intl_format": "+213 667 94 54 02",
        "e164_format": "+213667945402",
        "rfc3966_format": "tel:+213-667-94-54-02",
        "country_code": "DZ",
        "line_type": "MOBILE",
        "carrier": "Mobilis",
        "timezones": ["Europe/Paris"]
    }
}

9. メール件数

ドメインのメールアドレスの総数を取得します。

{
    "name": "email_count",
    "arguments": {
        "domain": "tomba.io"
    }
}

レスポンス:

{
    "domain": "tomba.io",
    "total": 245,
    "personalEmails": 198,
    "genericEmails": 47,
    "department": {
        "engineering": 45,
        "sales": 38,
        "marketing": 32,
        "hr": 15,
        "finance": 12,
        "legal": 8,
        "executive": 25,
        "support": 28,
        "other": 42
    },
    "seniority": {
        "junior": 89,
        "senior": 125,
        "executive": 31
    },
    "source": "tomba_email_count"
}

10. 類似検索

特定のドメインに基づいて類似ドメインを検索します。

{
    "name": "similar_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

レスポンス:

{
    "data": [
        {
            "website_url": "summit.com",
            "name": "Summit",
            "industries": "Wholesale"
        },
        {
            "website_url": "hunter.io",
            "name": "Hunter",
            "industries": "Information Technology and Services"
        },
        {
            "website_url": "voilaNorbert.com",
            "name": "VoilaNorbert",
            "industries": "Information Technology and Services"
        }
    ]
}

11. テクノロジー検索

任意の Web サイトのテクノロジースタックを即座に明らかにします。

{
    "name": "technology_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

レスポンス:

{
    "domain": "tomba.io",
    "data": [
        {
            "slug": "intercom",
            "name": "Intercom",
            "icon": "Intercom.png",
            "website": "https://www.intercom.com",
            "categories": {
                "id": 10,
                "slug": "analytics",
                "name": "Analytics"
            }
        }
    ]
}

12. 企業検索

場所、業界、規模、収益などの高度なフィルターを含む自然言語クエリを使用して企業を検索します。

{
    "name": "companies_search",
    "arguments": {
        "filters": {
            "location_city": {
                "include": ["san francisco"]
            },
            "industry": {
                "include": ["technology"]
            },
            "size": {
                "include": ["51-200", "201-500"]
            }
        },
        "page": 1,
        "limit": 10
    }
}

レスポンス:

{
    "data": {
        "companies": [
            {
                "name": "Tech Company Inc",
                "domain": "techcompany.com",
                "industry": "Technology",
                "location": {
                    "city": "San Francisco",
                    "state": "California",
                    "country": "United States"
                },
                "size": "51-200",
                "revenue": "$10M-$50M"
            }
        ],
        "total": 150,
        "page": 1
    }
}

利用可能なフィルター:

location_city: 含める/除外する配列で市区町村でフィルタリング
location_state: 含める/除外する配列で都道府県/州でフィルタリング
location_country: 含める/除外する配列で国でフィルタリング
industry: 業界でフィルタリング (LinkedIn Industry Codes V2 に基づく - 140 以上の業界)
type: 企業タイプでフィルタリング: education, government, nonprofit, private, public, personal
size: 企業規模でフィルタリング: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
revenue: 収益範囲でフィルタリング: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
founded: 含める/除外する配列で設立年でフィルタリング
keywords: 含める/除外する配列でキーワードでフィルタリング
sic: 含める/除外する配列で SIC コードでフィルタリング
naics: 含める/除外する配列で NAICS コードでフィルタリング
similar: 含める/除外する配列で類似ドメインでフィルタリング

レート制限と使用量

API レート制限

Tomba.io は、サブスクリプションプランに基づいてレート制限を実装しています。

無料プラン: 月間 50 リクエスト
Growth プラン: 月間 5,000 リクエスト + 10,000 検証リクエスト
Pro プラン: 月間 10,000 リクエスト
Enterprise プラン: 月間 50,000 リクエスト
カスタムプラン: カスタム制限

Tomba 価格プランの詳細をご覧ください。

レート制限ヘッダー

各 API レスポンスには、レート制限情報が含まれています。

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

Tomba API レート制限の詳細をご覧ください。

レート制限への対処

レート制限を超えると、API は 429 Too Many Requests ステータスを返します。

{
    "error": {
        "type": "rate_limit",
        "message": "Rate limit exceeded. Please try again in 60 seconds",
        "code": 429
    }
}

ベストプラクティス

使用状況の監視: tomba.io/dashboard でダッシュボードを確認してください
バックオフの実装: 429レスポンスに対して指数関数的バックオフで対応してください
バッチ操作: 同じドメインの複数メールアドレスにはドメイン検索を使用してください
結果のキャッシュ: 重複リクエストを避けるため、結果をローカルに保存してください
適切なプラン選択: 使用パターンに基づいてプランをアップグレードしてください

使用上のヒント

ドメイン検索は1リクエストで複数のメールアドレスを返します（個別検索より効率的です）
メール検証は有効なメール形式に対してのみクレジットを消費します
電話番号検索は1リクエストで複数の番号を返す場合があります
エンリッチメントは1回のリクエストで包括的なデータを提供します

トラブルシューティング

Claude Desktopでサーバーが起動しない場合

Node.jsバージョンの確認: Node.js 18以上がインストールされていることを確認してください
```
node --version
```
NPXを使用する場合:
- 初回実行時は安定したインターネット接続を確保してください
- -y フラグでインストールを自動承認する必要があります
- NPXは初回使用後にパッケージをキャッシュします
ローカルインストールを使用する場合:
- 設定ファイル内の絶対パスが正しいことを確認してください
- server/index.js が存在することを確認してください: ls -la server/index.js
- yarn build が正常に実行されたことを確認してください
API認証情報の確認: Tomba APIキーが正しいことを確認してください
Claudeログの確認:
- macOS: ~/Library/Logs/Claude/mcp*.log
- Windows: %APPDATA%\Claude\logs\mcp*.log

NPX固有の問題

「npx command not found」エラー:

npmがインストールされていることを確認してください: npm --version
NPXはnpm 5.2.0以降に同梱されています。必要に応じて更新してください: npm install -g npm

パッケージが見つからない場合:

パッケージが公開されていることを確認してください: npm view tomba-mcp-server
npmキャッシュのクリアを試してください: npm cache clean --force

常にパッケージをダウンロードする場合:

これは -y フラグを使用する場合の通常の動作です
NPXは初回ダウンロード後にパッケージをキャッシュします
永続的なインストールには、ローカルインストール方法を使用してください

認証エラー

https://app.tomba.io/dashboard でAPIキーを確認してください
環境変数が設定ファイルで正しく設定されていることを確認してください
APIサブスクリプションが有効であることを確認してください

ツールが応答しない場合

Tomba APIのレート制限を確認してください
ネットワーク接続を確認してください
サーバーログでエラーメッセージを確認してください

Tombaについて

2020年に設立されたTombaは、世界で最も信頼性が高く、正確で、詳細なメールアドレスデータのソースであることを誇りとしています。当社はテラバイト単位のデータを処理し、Email finder APIを提供しています。

コントリビューション

フォークする (https://github.com/tomba-io/tomba-mcp-server/fork)
フィーチャーブランチを作成する (git checkout -b my-new-feature)
変更をコミットする (git commit -am 'Add some feature')
ブランチにプッシュする (git push origin my-new-feature)
新しいプルリクエストを作成する

ライセンス

詳細については License ファイルを参照してください。

Tomba MCP Server

ドキュメント

Tomba.io MCP サーバー

機能

ツール (12 個利用可能)

リソース (7 個利用可能)

プロンプト (16 個の事前構築ワークフロー)

企業検索プロンプトのフィルターオプション

トランスポートオプション

インストール

前提条件

スクリーンショット

オプション 1: NPX 経由でインストール (推奨)

macOS/Linux

Windows

オプション 2: ソースからインストール

設定

OpenClaw スキル

Claude Desktop セットアップ

NPX を使用する場合 (推奨)

ローカルインストールを使用する場合

Tomba API 認証情報の取得

代替手段: HTTP トランスポートの使用

使用方法

コマンドラインオプション

スタンドアロン HTTP サーバー

HTTP API エンドポイント

HTTP リクエストの例

🔧 開発

開発コマンド

🔍 デバッグとテスト

MCP Inspector (推奨)

代替デバッグ方法

VS Code デバッグ

🧪 個別ツールのテスト

1. ドメイン検索

2. メール検索

3. メール検証

4. メールエンリッチメント

5. 著者検索

6. LinkedIn 検索

7. 電話番号検索

8. 電話番号検証

9. メール件数

10. 類似検索

11. テクノロジー検索

12. 企業検索

レート制限と使用量

API レート制限

レート制限ヘッダー

レート制限への対処

ベストプラクティス

使用上のヒント

トラブルシューティング

Claude Desktopでサーバーが起動しない場合

NPX固有の問題

認証エラー

ツールが応答しない場合

Tombaについて

コントリビューション

ライセンス

サポート