Tomba MCP

官方

Tomba，您独特的B2B邮箱查找与验证工具，提供独特的潜在客户数据库，助力轻松高效地扩展外联。

GitHub
8
试用此 MCP赞助

你可以用 Tomba MCP 做什么？

  • 查找某个域名的电子邮件地址 — 通过 domain_search 获取某家公司的所有联系人，并可按部门或国家等条件筛选。
  • 生成某人的电子邮件 — 使用 email_finder 根据姓名和域名构造一个可能的地址，然后进行验证。
  • 验证电子邮件的可投递性 — 使用 email_verifier 检查地址是否有效且可安全发送。
  • 丰富联系人资料 — 通过 email_enrichment 获取与电子邮件关联的职位、公司及社交链接。
  • 发现公司的技术栈 — 通过 technology_finder 识别网站所使用的工具和平台。
  • 查找相似公司 — 使用 similar_finder 定位用于潜在客户开发或分析的相似域名。

文档

Tomba Tomba.io MCP 服务器

一个用于与 Tomba.io API 集成的模型上下文协议（MCP）服务器。该服务器通过标准化的 MCP 接口提供全面的电子邮件发现、验证和丰富功能。

功能特性

工具（共 28 个）

电子邮件发现

验证

数据丰富

  • 电子邮件丰富：使用额外的联系人数据丰富电子邮件
  • 人物丰富：通过电子邮件查找人物数据（姓名、职位、社交资料）
  • 公司丰富：通过域名查找公司数据（行业、规模、位置）
  • 组合丰富：通过电子邮件进行人物 + 公司组合丰富

电话

域名情报

公司搜索

  • 公司搜索：使用自然语言查询和高级筛选器搜索公司

账户与管理

  • 账户信息：获取当前账户信息、套餐和积分
  • 使用情况信息：获取所有端点的 API 使用统计
  • 标记列表：列出已提交的数据标记及其状态和积分退款
  • 创建标记：报告错误数据（硬退信、无效电子邮件）以恢复积分
  • 潜在客户列表：列出潜在客户，可选用域名筛选
  • 创建潜在客户：向列表中添加新的潜在客户
  • 密钥列表：列出 API 密钥
  • 获取日志：获取最近的 API 请求日志

资源（共 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 - 从文章中查找记者联系方式
  • phone_finder - 查找联系人的电话号码
  • 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+ 个行业，包括计算机软件、金融服务、医院与医疗保健等）

性能与可靠性

超时

所有 API 调用都有 120 秒超时。Tomba 搜索针对实时基础设施进行实时运行——响应时间因目标公司的 SMTP 服务器速度、网站响应能力以及 catch-all 检测深度而异。

指数退避重试

所有 API 调用在以下情况下自动重试最多 3 次，并采用指数退避：

  • 429 Too Many Requests（超出速率限制）
  • 5xx 服务器错误

重试延迟：1 秒 → 2 秒 → 4 秒。

速率限制

速率限制按端点和套餐执行：

套餐每秒每分钟每天
免费版125
基础版350500
成长版5801,000
专业版81504,000
50,000+ 套餐无限无限无限

当 Tomba 无法提供结果时，不收取积分。30 天内的重复请求不会再次计数。

传输选项

  • 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 技能

此仓库现在包含一个工作区本地的 OpenClaw 技能，位于 skills/tomba-contact-intelligence/SKILL.md。

该技能旨在帮助 OpenClaw 为联系人发现、公司研究、电子邮件验证、电话查找和潜在客户丰富工作流选择正确的 Tomba MCP 工具。

使用方法：

  1. 将此仓库作为您的 OpenClaw 工作区打开，或将 skills/tomba-contact-intelligence 目录复制到您的 OpenClaw 技能目录中。
  2. 确保 Tomba MCP 服务器已配置并可供 OpenClaw 使用。
  3. 启动新的 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 凭据

  1. 访问 https://tomba.io
  2. 注册账户或登录
  3. 导航到您的仪表板
  4. 进入 API 设置
  5. 复制您的 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

这将打开一个 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，请使用附带的调试配置：

  • 调试 MCP 服务器：调试编译后的 JavaScript
  • 调试 TypeScript：直接调试 TypeScript 源码
  • 使用 Inspector 调试：使用 MCP Inspector 调试
  • 运行测试：调试 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": "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. 电子邮件查找器

根据域名、名字和姓氏生成可能的电子邮件地址。

{
    "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. 电子邮件验证器

验证电子邮件地址的可投递性并检查数据库存在情况。

{
    "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. 电子邮件丰富

使用额外的联系信息丰富电子邮件地址。

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

从 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 查找器

从 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. 电话查找器

根据电子邮件、域名或 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 次请求
  • 增长计划：每月 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
    }
}

最佳实践

  1. 监控用量：在 tomba.io/dashboard 查看您的仪表盘
  2. 实现退避策略：使用指数退避处理 429 响应
  3. 批量操作：使用域名搜索获取同一域名的多个邮箱
  4. 缓存结果：在本地存储结果以避免重复请求
  5. 合理规划：根据使用模式升级您的套餐

使用技巧

  • 域名搜索每次请求可返回多个邮箱（比单独查询更高效）
  • 邮箱验证仅对有效邮箱格式消耗积分
  • 电话查找每次请求可能返回多个号码
  • 数据丰富服务可在单次请求中提供全面的数据

故障排查

服务器无法在 Claude Desktop 中启动

  1. 检查 Node.js 版本：确保您安装了 Node.js 18 或更高版本

    node --version

  2. 使用 NPX：

    • 确保首次运行时网络连接稳定
    • -y 标志应自动接受安装
    • NPX 在首次使用后会缓存该包

  3. 使用本地安装：

    • 验证配置中的绝对路径是否正确
    • 确保 server/index.js 存在：ls -la server/index.js
    • 确保您已成功运行 yarn build

  4. 验证 API 凭据：确保您的 Tomba API 密钥正确

  5. 检查 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 在首次下载后会缓存该包
  • 如需永久安装，请使用本地安装方法

身份验证错误

工具无响应

  • 检查您的 Tomba API 速率限制
  • 验证网络连接
  • 查看服务器日志中的错误信息

关于 Tomba

Tomba 成立于 2020 年，以提供最可靠、最准确、最深入的邮箱地址数据来源而自豪。我们处理 TB 级数据来生成我们的邮箱查找 API。

image

贡献指南

  1. Fork 本仓库（https://github.com/tomba-io/tomba-mcp-server/fork）
  2. 创建您的功能分支（git checkout -b my-new-feature）
  3. 提交您的更改（git commit -am 'Add some feature'）
  4. 推送到分支（git push origin my-new-feature）
  5. 创建新的 Pull Request

许可证

请参阅 许可证 文件了解更多信息。

支持