Tomba MCP Server

官方

Tomba，您獨特的B2B電子郵件查找與驗證工具，提供獨特的潛在客戶資料庫，讓您輕鬆有效地擴大業務拓展規模。

GitHub

文件

Tomba.io MCP 伺服器

一個用於整合 Tomba.io API 的模型上下文協定 (MCP) 伺服器。此伺服器透過標準化的 MCP 介面，提供全面的電子郵件發現、驗證和擴充功能。

功能特色

工具 (共 12 個可用)

網域搜尋：尋找與某個網域相關聯的所有電子郵件地址
電子郵件查找器：根據姓名和網域產生可能的電子郵件地址
電子郵件驗證器：驗證電子郵件的可送達性並檢查資料庫中的存在情況
電子郵件擴充：使用額外的聯絡人資料來擴充電子郵件
作者查找器：發現文章作者的電子郵件地址
LinkedIn 查找器：從 LinkedIn 個人資料網址尋找電子郵件
電話查找器：透過電子郵件、網域或 LinkedIn 搜尋電話號碼
電話驗證器：驗證電話號碼並檢查電信業者資訊
電子郵件計數：取得網域的電子郵件總數
相似網域查找器：根據目標網域尋找相似的網域
技術查找器：發現網站所使用的技術堆疊
公司搜尋：使用自然語言查詢和進階篩選條件來搜尋公司

資源 (共 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 - 對網站進行全面的技術稽核
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 產業代碼 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

這會開啟一個網頁介面，您可以在其中：

📋 檢視所有可用的工具
🧪 互動式測試工具
📊 檢查請求/回應
🐛 即時除錯

替代的除錯方法

# 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. 作者查找器

從網址尋找文章作者的電子郵件地址。

{
    "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 個人資料網址尋找電子郵件地址。

{
    "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. 技術查找器

即時揭示任何網站的技術堆疊。

{
    "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 產業代碼 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 個請求
Custom 方案：自訂限制

深入了解 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 回應
批次操作：使用網域搜尋來查找同一網域的多個電子郵件
快取結果：將結果儲存在本地以避免重複請求
妥善規劃：根據使用模式升級您的方案

使用提示

網域搜尋每次請求可返回多個電子郵件（比個別查詢更有效率）
電子郵件驗證僅對有效的電子郵件格式消耗點數
電話查找每次請求可能返回多個號碼
豐富化功能可在單一請求中提供全面的資料

疑難排解

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 命令未找到」：

確保已安裝 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

Tomba 成立於 2020 年，以成為全球最可靠、最準確且最深入的電子郵件地址資料來源而自豪。我們處理數 TB 的資料來產生我們的 Email finder API。

貢獻

Fork 它 (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)
建立新的 Pull Request

授權

請參閱授權檔案以獲取更多資訊。

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

貢獻

授權

支援