Tomba MCP

官方

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

GitHub

你可以用 Tomba MCP 做什麼？

按域名查找電子郵件地址 — 透過 domain_search 列出公司的所有電子郵件，支援分頁與篩選。
生成個人的電子郵件 — 使用 email_finder 從姓名和域名建構可能的地址，再進行驗證。
驗證電子郵件可送達性 — 使用 email_verifier 檢查地址的狀態、評分及 MX/SMTP 檢查。
豐富聯絡人資料 — 使用 email_enrichment 提取電子郵件的完整詳細資訊，如職稱、LinkedIn 和電話。
發現作者或 LinkedIn 電子郵件 — 透過 author_finder 從文章 URL 提取聯絡人，或使用 linkedin_finder 從個人資料提取。
研究公司與技術棧 — 使用帶篩選器的 companies_search、用於競爭對手的 similar_finder，以及用於技術棧洞察的 technology_finder。

文件

Tomba.io MCP Server

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

功能

工具（12 個可用）

Domain Search：尋找與某個網域關聯的所有電子郵件地址
Email Finder：根據名字和網域產生可能的電子郵件地址
Email Verifier：驗證電子郵件可送達性並檢查資料庫存在性
Email Enrichment：使用其他聯絡資料豐富電子郵件
Author Finder：發現文章作者的電子郵件地址
LinkedIn Finder：從 LinkedIn 個人檔案 URL 尋找電子郵件
Phone Finder：依電子郵件、網域或 LinkedIn 搜尋電話號碼
Phone Validator：驗證電話號碼並檢查電信業者資訊
Email Count：取得網域的電子郵件總數
Similar Finder：根據目標網域尋找相似網域
Technology Finder：發現網站使用的技術堆疊
Companies Search：使用自然語言查詢與進階篩選器搜尋公司

資源（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

注意： npm 套件已從 tomba-mcp-server 重新命名為 @tomba-io/tomba-mcp-server。請相應更新您的設定。

選項 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-io/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-io/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 合作夥伴的最佳聯絡人，並在回傳前驗證電子郵件。"
"研究德國金融科技公司，然後為最匹配的公司識別可能的銷售聯絡人。"
"使用電子郵件、電話、公司技術和類似競爭者豐富此潛在客戶：jane@acme.com"

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-io/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-io/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-io/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. Domain Search

搜尋與網域名稱關聯的電子郵件地址。

{
    "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": "b.mohamed@tomba.io",
        "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. Email Finder

根據網域、名字和姓氏產生可能的電子郵件地址。

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

回應：

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "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. Email Verifier

驗證電子郵件地址的可送達性並檢查資料庫存在性。

{
    "name": "email_verifier",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

回應：

{
    "data": {
        "email": {
            "email": "b.mohamed@tomba.io",
            "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. Email Enrichment

使用其他聯絡資訊豐富電子郵件地址。

{
    "name": "email_enrichment",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

回應：

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "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. Author Finder

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

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

回應：

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "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 Finder

從 LinkedIn 個人檔案 URL 尋找電子郵件地址。

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

回應：

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "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. Phone Finder

根據電子郵件、網域或 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. Phone Validator

驗證電話號碼並檢查電信業者資訊。

{
    "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. Email Count

取得網域的電子郵件地址總數。

{
    "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. Similar Finder

根據特定網域尋找相似的網域。

{
    "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. Technology Finder

立即揭露任何網站的技術堆疊。

{
    "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. Companies Search

使用自然語言查詢與進階篩選器（包括地點、產業、規模和營收）搜尋公司。

{
    "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 個請求
成長方案：每月 5,000 個請求 + 10,000 個驗證請求
專業方案：每月 10,000 個請求
企業方案：每月 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 回應
批次操作：對同一網域的多個電子郵件使用網域搜尋
快取結果：將結果儲存在本機，避免重複請求
妥善規劃：根據使用模式升級您的方案

使用提示

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

疑難排解

伺服器無法在 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-io/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。

貢獻

建立分支 (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

授權

請參閱 License 檔案以了解更多資訊。

Tomba MCP

你可以用 Tomba MCP 做什麼？

文件

Tomba.io MCP Server

功能

工具（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. Domain Search

2. Email Finder

3. Email Verifier

4. Email Enrichment

5. Author Finder

6. LinkedIn Finder

7. Phone Finder

8. Phone Validator

9. Email Count

10. Similar Finder

11. Technology Finder

12. Companies Search

速率限制與使用

API 速率限制

速率限制標頭

處理速率限制

最佳實踐

使用提示

疑難排解

伺服器無法在 Claude Desktop 中啟動

NPX 特定問題

驗證錯誤

工具無回應

關於 Tomba

貢獻

授權

支援