Tomba MCP

chính thức

Tomba, công cụ tìm kiếm và xác minh email B2B độc đáo của bạn, cung cấp cơ sở dữ liệu khách hàng tiềm năng đặc biệt để mở rộng tiếp cận một cách dễ dàng và hiệu quả.

GitHub
8

Bạn có thể làm gì với Tomba MCP?

  • Tìm email theo tên miền — Yêu cầu liệt kê tất cả email của một công ty qua domain_search, với phân trang và bộ lọc.
  • Tạo email cho một người — Sử dụng email_finder để xây dựng địa chỉ khả dĩ từ tên và tên miền, sau đó xác minh nó.
  • Xác minh khả năng gửi email — Kiểm tra một địa chỉ bằng email_verifier để biết trạng thái, điểm số và các kiểm tra MX/SMTP.
  • Làm phong phú hồ sơ liên hệ — Lấy chi tiết đầy đủ như chức danh, LinkedIn và số điện thoại cho một email bằng email_enrichment.
  • Khám phá email tác giả hoặc LinkedIn — Trích xuất danh bạ từ URL bài viết qua author_finder hoặc từ hồ sơ bằng linkedin_finder.
  • Nghiên cứu công ty và công nghệ — Sử dụng companies_search với bộ lọc, similar_finder cho đối thủ cạnh tranh và technology_finder để hiểu về hệ thống công nghệ.

Tài liệu

Tomba Máy chủ MCP Tomba.io

Máy chủ Model Context Protocol (MCP) để tích hợp với API Tomba.io. Máy chủ này cung cấp các khả năng khám phá, xác minh và làm phong phú email toàn diện thông qua giao diện MCP chuẩn hóa.

Tính năng

Công cụ (12 công cụ có sẵn)

  • Domain Search: Tìm tất cả địa chỉ email liên kết với một tên miền
  • Email Finder: Tạo các địa chỉ email khả dĩ từ tên và tên miền
  • Email Verifier: Xác minh khả năng gửi email và kiểm tra sự hiện diện trong cơ sở dữ liệu
  • Email Enrichment: Làm phong phú email với dữ liệu liên hệ bổ sung
  • Author Finder: Khám phá địa chỉ email của tác giả bài viết
  • LinkedIn Finder: Tìm email từ URL hồ sơ LinkedIn
  • Phone Finder: Tìm kiếm số điện thoại theo email, tên miền hoặc LinkedIn
  • Phone Validator: Xác thực số điện thoại và kiểm tra thông tin nhà mạng
  • Email Count: Lấy tổng số email cho các tên miền
  • Similar Finder: Tìm các tên miền tương tự dựa trên tên miền mục tiêu
  • Technology Finder: Khám phá các công nghệ mà trang web đang sử dụng
  • Companies Search: Tìm kiếm công ty bằng truy vấn ngôn ngữ tự nhiên với bộ lọc nâng cao

Tài nguyên (7 tài nguyên có sẵn)

  • tomba://api/status - Trạng thái API và thông tin tài khoản
  • tomba://domain/{domain} - Thông tin tên miền
  • tomba://email/{email} - Thông tin email
  • tomba://similar/{domain} - Phân tích tên miền tương tự
  • tomba://technology/{domain} - Thông tin công nghệ
  • tomba://docs/api - Tài liệu API
  • tomba://docs/tools - Tài liệu công cụ

Lời nhắc (16 quy trình làm việc được xây dựng sẵn)

  • find_contact - Tìm thông tin liên hệ đầy đủ cho một người
  • verify_email_list - Xác minh hàng loạt địa chỉ email
  • research_company - Nghiên cứu liên hệ và cơ cấu công ty
  • enrich_lead - Làm phong phú một khách hàng tiềm năng với tất cả dữ liệu có sẵn
  • find_journalists - Tìm liên hệ nhà báo từ các bài viết
  • finder_phone - Tìm số điện thoại cho các liên hệ
  • validate_phone - Xác thực một số điện thoại
  • competitor_analysis - Phân tích đối thủ cạnh tranh bằng cách sử dụng tên miền và công nghệ tương tự
  • technology_audit - Kiểm tra công nghệ toàn diện của một trang web
  • domain_insights - Nhận thông tin chi tiết toàn diện về một tên miền bao gồm số lượng email và công nghệ
  • bulk_domain_research - Nghiên cứu nhiều tên miền để lấy số lượng email và thông tin cơ bản
  • find_target_companies - Tìm công ty với bộ lọc nâng cao (quy mô, loại hình, doanh thu, ngành)
  • market_research - Nghiên cứu các công ty trong một phân khúc thị trường với bộ lọc toàn diện
  • lead_generation - Tạo khách hàng tiềm năng bằng cách tìm công ty và liên hệ của họ
  • prospect_enrichment - Làm phong phú khách hàng tiềm năng của công ty với dữ liệu toàn diện
  • industry_analysis - Phân tích các công ty trong một ngành với phân khúc chi tiết

Tùy chọn bộ lọc cho lời nhắc tìm kiếm công ty

Bộ lọcGiá trị có sẵn
Quy mô1-10 (Siêu nhỏ), 11-50 (Nhỏ), 51-250 (Vừa), 251-1K (Trung bình-lớn), 1K-5K (Lớn), 5K-10K (Rất lớn), 10K-50K (Doanh nghiệp), 50K-100K (Khổng lồ), 100K+ (Toàn cầu)
Loại hìnheducation, government, nonprofit, private, public, personal
Doanh thu$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
NgànhDựa trên Mã ngành LinkedIn V2 (hơn 140 ngành bao gồm Phần mềm máy tính, Dịch vụ tài chính, Bệnh viện & Chăm sóc sức khỏe, v.v.)

Tùy chọn truyền tải

  • stdio - Đầu vào/đầu ra chuẩn (mặc định, dành cho Claude Desktop)
  • http - Máy chủ HTTP với các điểm cuối REST

Cài đặt

Điều kiện tiên quyết

Ảnh chụp màn hình

Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5

Lưu ý: Gói npm đã được đổi tên từ tomba-mcp-server thành @tomba-io/tomba-mcp-server. Vui lòng cập nhật cấu hình của bạn cho phù hợp.

Tùy chọn 1: Cài đặt qua NPX (Khuyến nghị)

Cách dễ nhất để sử dụng máy chủ Tomba MCP là thông qua npx, không cần sao chép kho lưu trữ:

macOS/Linux

Thêm vào claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json) của bạn:

{
    "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

Thêm vào claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json) của bạn:

{
    "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"
            }
        }
    }
}

Lưu ý: Cờ -y tự động chấp nhận lời nhắc cài đặt và npx sẽ luôn tải phiên bản mới nhất.

Tùy chọn 2: Cài đặt từ mã nguồn

Nếu bạn muốn sửa đổi máy chủ hoặc đóng góp cho quá trình phát triển:

# 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

Cấu hình

Kỹ năng OpenClaw

Kho lưu trữ này hiện bao gồm một kỹ năng OpenClaw cục bộ trong không gian làm việc tại skills/tomba-contact-intelligence/SKILL.md.

Kỹ năng này được thiết kế để giúp OpenClaw chọn đúng công cụ Tomba MCP cho các quy trình làm việc khám phá liên hệ, nghiên cứu công ty, xác minh email, tra cứu số điện thoại và làm phong phú khách hàng tiềm năng.

Để sử dụng:

  1. Mở kho lưu trữ này làm không gian làm việc OpenClaw của bạn hoặc sao chép thư mục skills/tomba-contact-intelligence vào thư mục kỹ năng OpenClaw của bạn.
  2. Đảm bảo máy chủ Tomba MCP được cấu hình và khả dụng cho OpenClaw.
  3. Bắt đầu phiên OpenClaw mới để kỹ năng được tải.

Ví dụ về lời nhắc:

  • "Tìm liên hệ tốt nhất cho quan hệ đối tác tại stripe.com và xác minh email trước khi trả về."
  • "Nghiên cứu các công ty fintech tại Đức, sau đó xác định các liên hệ bán hàng khả dĩ cho các kết quả hàng đầu."
  • "Làm phong phú khách hàng tiềm năng này với email, điện thoại, công nghệ công ty và đối thủ cạnh tranh tương tự: jane@acme.com"

Thiết lập Claude Desktop

Để sử dụng máy chủ này với Claude Desktop, hãy thêm cấu hình vào tệp claude_desktop_config.json của bạn.

Sử dụng NPX (Khuyến nghị)

Phương pháp này tự động sử dụng phiên bản đã phát hành mới nhất:

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"
            }
        }
    }
}

Sử dụng cài đặt cục bộ

Nếu bạn đã xây dựng từ mã nguồn, hãy sử dụng đường dẫn tuyệt đối đến bản cài đặt của bạn:

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"
            }
        }
    }
}

Lưu ý quan trọng:

  • Thay thế your-api-key-here và your-secret-key-here bằng thông tin xác thực API Tomba thực tế của bạn
  • Đối với cài đặt cục bộ, hãy thay thế /ABSOLUTE/PATH/TO/tomba-mcp-server bằng đường dẫn đầy đủ đến thư mục cài đặt của bạn
  • Khởi động lại Claude Desktop sau khi cập nhật cấu hình

Lấy thông tin xác thực API Tomba

  1. Truy cập https://tomba.io
  2. Đăng ký tài khoản hoặc đăng nhập
  3. Điều hướng đến bảng điều khiển của bạn
  4. Vào cài đặt API
  5. Sao chép API Key và Secret Key của bạn

Thay thế: Sử dụng truyền tải HTTP

Đối với truyền tải HTTP với npx:

{
    "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"
            }
        }
    }
}

Đối với truyền tải HTTP với cài đặt cục bộ:

{
    "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"
            }
        }
    }
}

Cách sử dụng

Tùy chọn dòng lệnh

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

Máy chủ HTTP độc lập

Bạn cũng có thể chạy máy chủ như một dịch vụ HTTP độc lập:

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

Điểm cuối API HTTP

  • POST /mcp - Gửi yêu cầu JSON-RPC
  • GET /mcp - Server-Sent Events cho thông báo (yêu cầu tiêu đề X-Session-Id)
  • DELETE /mcp - Kết thúc một phiên (yêu cầu tiêu đề X-Session-Id)
  • GET /health - Điểm cuối kiểm tra sức khỏe
  • GET /sessions - Liệt kê các phiên đang hoạt động (yêu cầu xác thực)

Ví dụ yêu cầu 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
  }'

🔧 Phát triển

Lệnh phát triển

# 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

🔍 Gỡ lỗi & Kiểm thử

MCP Inspector (Khuyến nghị)

Cách dễ nhất để kiểm tra và gỡ lỗi máy chủ MCP của bạn:

# Build and launch MCP Inspector
yarn debug

Thao tác này mở giao diện web nơi bạn có thể:

  • 📋 Xem tất cả các công cụ có sẵn
  • 🧪 Kiểm tra công cụ tương tác
  • 📊 Kiểm tra yêu cầu/phản hồi
  • 🐛 Gỡ lỗi theo thời gian thực

Phương pháp gỡ lỗi thay thế

# 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

Gỡ lỗi VS Code

Nếu sử dụng VS Code, hãy sử dụng các cấu hình gỡ lỗi được bao gồm:

  • Debug MCP Server: Gỡ lỗi JavaScript đã biên dịch
  • Debug TypeScript: Gỡ lỗi trực tiếp mã nguồn TypeScript
  • Debug with Inspector: Gỡ lỗi với MCP Inspector
  • Run Tests: Gỡ lỗi kiểm thử Jest

Xem DEBUG_GUIDE.md để biết hướng dẫn gỡ lỗi toàn diện.

🧪 Kiểm thử từng công cụ

1. Domain Search

Tìm kiếm địa chỉ email liên kết với một tên miền.

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

Phản hồi:

{
  "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

Tạo địa chỉ email khả dĩ từ tên miền, tên và họ.

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

Phản hồi:

{
    "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

Xác minh khả năng gửi email và kiểm tra sự hiện diện trong cơ sở dữ liệu.

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

Phản hồi:

{
    "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

Làm phong phú địa chỉ email với thông tin liên hệ bổ sung.

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

Phản hồi:

{
    "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

Tìm địa chỉ email của tác giả bài viết từ một URL.

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

Phản hồi:

{
    "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

Tìm địa chỉ email từ URL hồ sơ LinkedIn.

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

Phản hồi:

{
    "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

Tìm kiếm số điện thoại dựa trên email, tên miền hoặc hồ sơ LinkedIn.

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

Phản hồi:

{
    "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

Xác thực số điện thoại và kiểm tra thông tin nhà mạng.

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

Phản hồi:

{
    "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

Lấy tổng số địa chỉ email cho một tên miền.

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

Phản hồi:

{
    "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

Tìm các tên miền tương tự dựa trên một tên miền cụ thể.

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

Phản hồi:

{
    "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

Tiết lộ ngay lập tức công nghệ của bất kỳ trang web nào.

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

Phản hồi:

{
    "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

Tìm kiếm công ty bằng truy vấn ngôn ngữ tự nhiên với bộ lọc nâng cao bao gồm vị trí, ngành, quy mô và doanh thu.

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

Phản hồi:

{
    "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
    }
}

Bộ lọc có sẵn:

  • location_city: Lọc theo thành phố với mảng bao gồm/loại trừ
  • location_state: Lọc theo tiểu bang với mảng bao gồm/loại trừ
  • location_country: Lọc theo quốc gia với mảng bao gồm/loại trừ
  • industry: Lọc theo ngành (dựa trên Mã ngành LinkedIn V2 - hơn 140 ngành)
  • type: Lọc theo loại hình công ty: education, government, nonprofit, private, public, personal
  • size: Lọc theo quy mô công ty: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
  • revenue: Lọc theo khoảng doanh thu: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
  • founded: Lọc theo năm thành lập với mảng bao gồm/loại trừ
  • keywords: Lọc theo từ khóa với mảng bao gồm/loại trừ
  • sic: Lọc theo mã SIC với mảng bao gồm/loại trừ
  • naics: Lọc theo mã NAICS với mảng bao gồm/loại trừ
  • similar: Lọc theo tên miền tương tự với mảng bao gồm/loại trừ

Giới hạn tốc độ & cách sử dụng

Giới hạn tốc độ API

Tomba.io triển khai giới hạn tốc độ dựa trên gói đăng ký của bạn:

  • Gói miễn phí: 50 yêu cầu mỗi tháng
  • Gói Growth: 5.000 yêu cầu mỗi tháng + 10.000 yêu cầu xác minh
  • Gói Pro: 10.000 yêu cầu mỗi tháng
  • Gói Enterprise: 50.000 yêu cầu mỗi tháng
  • Gói tùy chỉnh: Giới hạn tùy chỉnh

Tìm hiểu thêm về Gói giá Tomba.

Tiêu đề giới hạn tốc độ

Mỗi phản hồi API bao gồm thông tin giới hạn tốc độ:

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

Tìm hiểu thêm về Giới hạn tốc độ API Tomba.

Xử lý Giới hạn Tốc độ

Khi bạn vượt quá giới hạn tốc độ, API trả về trạng thái 429 Too Many Requests với:

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

Các Thực hành Tốt nhất

  1. Theo dõi Sử dụng: Kiểm tra bảng điều khiển của bạn tại tomba.io/dashboard
  2. Triển khai Backoff: Xử lý phản hồi 429 với backoff theo cấp số nhân
  3. Thao tác Hàng loạt: Sử dụng tìm kiếm tên miền cho nhiều email từ cùng một tên miền
  4. Lưu Kết quả vào Bộ nhớ đệm: Lưu trữ kết quả cục bộ để tránh các yêu cầu trùng lặp
  5. Lên Kế hoạch Phù hợp: Nâng cấp gói của bạn dựa trên các mẫu sử dụng

Mẹo Sử dụng

  • Tìm kiếm tên miền trả về nhiều email mỗi yêu cầu (hiệu quả hơn so với tra cứu từng email riêng lẻ)
  • Xác minh email chỉ tiêu tốn tín dụng cho các định dạng email hợp lệ
  • Trình tìm số điện thoại có thể trả về nhiều số mỗi yêu cầu
  • Làm phong phú dữ liệu cung cấp dữ liệu toàn diện trong một yêu cầu duy nhất

Khắc phục sự cố

Máy chủ Không Khởi động trong Claude Desktop

  1. Kiểm tra phiên bản Node.js: Đảm bảo bạn có Node.js 18 trở lên

    node --version

  2. Sử dụng NPX:

    • Đảm bảo bạn có kết nối internet ổn định cho lần chạy đầu tiên
    • Cờ -y sẽ tự động chấp nhận cài đặt
    • NPX sẽ lưu gói vào bộ nhớ đệm sau lần sử dụng đầu tiên

  3. Sử dụng Cài đặt Cục bộ:

    • Xác minh đường dẫn tuyệt đối là chính xác trong cấu hình của bạn
    • Đảm bảo server/index.js tồn tại: ls -la server/index.js
    • Đảm bảo bạn đã chạy yarn build thành công

  4. Xác minh thông tin xác thực API: Đảm bảo khóa API Tomba của bạn là chính xác

  5. Kiểm tra nhật ký Claude:

    • macOS: ~/Library/Logs/Claude/mcp*.log
    • Windows: %APPDATA%\Claude\logs\mcp*.log

Các Vấn đề Cụ thể với NPX

"Không tìm thấy lệnh npx":

  • Đảm bảo npm được cài đặt: npm --version
  • NPX đi kèm với npm 5.2.0+, cập nhật nếu cần: npm install -g npm

Không tìm thấy gói:

  • Xác minh gói đã được xuất bản: npm view @tomba-io/tomba-mcp-server
  • Thử xóa bộ nhớ đệm npm: npm cache clean --force

Luôn tải xuống gói:

  • Đây là hành vi bình thường với cờ -y
  • NPX lưu gói vào bộ nhớ đệm sau lần tải xuống đầu tiên
  • Để cài đặt vĩnh viễn, hãy sử dụng phương pháp cài đặt cục bộ

Lỗi Xác thực

  • Xác minh khóa API của bạn tại https://app.tomba.io/dashboard
  • Đảm bảo các biến môi trường được đặt đúng trong cấu hình
  • Kiểm tra rằng đăng ký API của bạn đang hoạt động

Công cụ Không Phản hồi

  • Kiểm tra giới hạn tốc độ API Tomba của bạn
  • Xác minh kết nối mạng
  • Xem lại nhật ký máy chủ để tìm thông báo lỗi

Về Tomba

Được thành lập vào năm 2020, Tomba tự hào là nguồn dữ liệu địa chỉ email đáng tin cậy, chính xác và chuyên sâu nhất hiện có ở bất kỳ đâu. Chúng tôi xử lý hàng terabyte dữ liệu để tạo ra API Tìm email của mình.

image

Đóng góp

  1. Fork nó (https://github.com/tomba-io/tomba-mcp-server/fork)
  2. Tạo nhánh tính năng của bạn (git checkout -b my-new-feature)
  3. Commit các thay đổi của bạn (git commit -am 'Add some feature')
  4. Push lên nhánh (git push origin my-new-feature)
  5. Tạo Pull Request mới

Giấy phép

Vui lòng xem tệp Giấy phép để biết thêm thông tin.

Hỗ trợ