Indiamart Lead Manager

🇮🇳 IndiaMART MCP サーバー

Claude AI と IndiaMART の Lead Management API を接続する、完全に機能する Model Context Protocol（MCP）サーバーです。自然言語を使って、IndiaMART の購入者リードを取得、検索、分析、管理できます。

⚡ クイックインストール（60 秒）

git clone https://github.com/Techmatic-sys/indiamart-mcp-server.git
cd indiamart-mcp-server
pip install -r requirements.txt

次に、Claude Desktop の設定に追加すれば完了です。詳しいセットアップ手順は以下をご覧ください。

---

✨ 機能

• 10 個の MCP ツール — CRM の全機能に対応する 8 個の読み取りツールと 2 個の書き込みツール
• リードの取得 — 任意の期間のリードを IndiaMART から取得
• パイプライン管理 — 営業ステージに沿ってリードを追跡（新規 → 成約）
• メモ — 参考情報として、リードに非公開メモを添付
• リアルタイム Webhook — IndiaMART の Push API 経由でリードを即時受信
• ローカルデータベース — すべてのリードを SQLite に保存し、高速なオフラインアクセスを実現
• 分析 — 都市、製品、日付ごとの統計情報を取得
• 検索 — 製品名やメッセージ内のキーワードでリードを検索
• CSV エクスポート — スプレッドシートやレポート用にリードをエクスポート
• 返信文の下書き — 購入者へのプロフェッショナルな返信をすぐに作成
• 入力検証 — Pydantic スキーマで不正なクエリを防止
• 再試行ロジック — API エラー時に指数バックオフで再試行
• Claude Desktop にすぐ対応 — プラグアンドプレイの設定を同梱

---

📋 前提条件

• Python 3.10+（ダウンロード）
• IndiaMART Seller Account（Lead Manager へのアクセス権が必要）
• IndiaMART CRM API Key（取得方法は以下を参照）
• Claude Desktop（任意。AI を活用したリード管理に使用）

---

🚀 インストール

1. クローンまたはダウンロード

git clone https://github.com/Techmatic-sys/indiamart-mcp-server.git
cd indiamart-mcp-server

2. 仮想環境を作成（推奨）

python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

3. 依存関係をインストール

# MCP server only (lightweight, 4 packages)
pip install -r requirements.txt

# Full SaaS web app (includes FastAPI, uvicorn, etc.)
pip install -r requirements-saas.txt

4. 環境を設定

# Copy the example env file
cp .env.example .env    # Linux/macOS
copy .env.example .env  # Windows

# Edit .env with your credentials

---

🔑 IndiaMART API キーの取得方法

1. IndiaMART Seller Dashboard にログインします
2. Lead Manager → Settings（⚙️ アイコン）に移動します
3. CRM Integration または API Settings を開きます
4. CRM API Key（glusr_crm_key）を生成するか、コピーします
5. アカウントプロフィールで GLID（Global Login ID）を確認します
6. 2 つの値を .env ファイルに貼り付けます

注記： API キーを使うと、リードにアクセスできます。秘密にしておいてください。

---

▶️ MCP サーバーの実行

# Standard run (Claude Desktop starts this automatically)
python mcp_server.py

# Check version
python mcp_server.py --version

# Health check (verify DB connectivity)
python mcp_server.py --health

---

🖥️ Claude Desktop への接続

1. Claude Desktop の設定ファイルを探す

OS	パス
Windows	%APPDATA%\Claude\claude_desktop_config.json
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

2. MCP サーバーを追加

{
  "mcpServers": {
    "indiamart": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "/ABSOLUTE/PATH/TO/indiamart-mcp-server",
      "env": {
        "INDIAMART_API_KEY": "your_crm_api_key_here",
        "INDIAMART_GLID": "your_glid_here"
      }
    }
  }
}

cwd を実際のパスに置き換えてください：

• Windows： "C:\\Users\\YourName\\indiamart-mcp-server"
• macOS： "/Users/yourname/indiamart-mcp-server"
• Linux： "/home/yourname/indiamart-mcp-server"

3. Claude Desktop を再起動

Claude Desktop を終了して、再度開きます。ツールメニューに IndiaMART のツールが表示されます。

---

🤖 Claude Code への接続

オプション 1：CLI（推奨）

claude mcp add indiamart -- python /ABSOLUTE/PATH/TO/indiamart-mcp-server/mcp_server.py

次に、環境変数を設定します。

# In your shell profile or before launching Claude Code
export INDIAMART_API_KEY="your_crm_api_key_here"
export INDIAMART_GLID="your_glid_here"

オプション 2：手動設定

プロジェクトレベルの .claude/settings.json またはグローバル設定の ~/.claude/settings.json に追加します。

{
  "mcpServers": {
    "indiamart": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/TO/indiamart-mcp-server/mcp_server.py"],
      "env": {
        "INDIAMART_API_KEY": "your_crm_api_key_here",
        "INDIAMART_GLID": "your_glid_here"
      }
    }
  }
}

mcp_server.py の実際の絶対パスに置き換えてください。

接続の確認

接続したら、Claude Code に次のように尋ねてください。

• 「IndiaMART の最新リードを同期して」
• 「過去 24 時間のリードを表示して」
• 「リードの統計情報を教えて」

---

🦞 OpenClaw への接続

OpenClaw はセルフホスト可能な AI エージェントプラットフォームです。IndiaMART のリードは OpenClaw のネイティブスキルとなり、OpenClaw がサポートするあらゆるインターフェースから利用できます。

1. OpenClaw の設定ファイルを見つける

OS	パス
Linux/macOS	~/.openclaw/openclaw.json
Windows	C:\Users\YourName\.openclaw\openclaw.json

2. IndiaMART スキルを追加する

設定ファイルを開き、skills.mcpServers の下に追加します：

{
  skills: {
    mcpServers: {
      indiamart: {
        command: "python",
        args: ["mcp_server.py"],
        cwd: "/absolute/path/to/indiamart-mcp-server",
        env: {
          INDIAMART_API_KEY: "your_crm_api_key_here",
          INDIAMART_GLID: "your_glid_here"
        }
      }
    }
  }
}

すぐにコピーして使えるテンプレートについては、リポジトリのルートにある openclaw-config-example.json5 をご覧ください。

3. OpenClaw ゲートウェイを再起動する

openclaw gateway restart

4. 読み込まれたことを確認する

openclaw status --all
# You should see "indiamart" listed with 10 tools

リモート OpenClaw（VPS / EC2）

サーバー上で MCP サーバーを SSE モードで実行します：

python mcp_server.py --transport sse --host 0.0.0.0 --port 8000

次に、OpenClaw の設定で http://your-server-ip:8000 を指定します。

---

💬 プロンプトの例

プロンプト	動作
"過去24時間のすべてのリードを表示して"	最近のリードを同期して表示します
"今週獲得したリードは何件で、どの都市からですか？"	リードの統計情報を表示します
"鋼管について問い合わせているリードを検索して"	商品やメッセージをキーワード検索します
"リード ID IML123456789 への返信文を作成して"	購入者への丁寧な返信文を作成します
"リード IML123 を有望ステージに移動して"	パイプラインのステージを更新します
"リード IML123 にメモを追加して：まとめ買いに非常に関心あり"	メモを追加します
"2026年1月のすべてのリードを CSV でエクスポートして"	リードを CSV 形式でエクスポートします
"最新の IndiaMART リードを同期して"	最新のリードをローカル DB に取り込みます

---

🛠️ 利用可能な MCP ツール（合計 10 個）

読み取りツール（8 個）

ツール	説明
tool_get_leads_by_date	指定した期間の IndiaMART のリードを取得します
tool_get_recent_leads	過去 N 時間のリードを取得します
tool_get_lead_stats	分析情報：合計数、都市別、商品別、日付別
tool_search_leads	キーワードでリードを検索します
tool_get_lead_by_id	特定のリードの詳細情報を取得します
tool_draft_reply	購入者への丁寧な返信文を作成します
tool_export_leads_csv	リードを CSV としてエクスポートします
tool_sync_latest_leads	IndiaMART からローカル DB に最新情報を同期します

書き込みツール（2 個 — 新機能）

ツール	説明
tool_update_lead_stage	パイプライン内でリードを移動します（新規 → 連絡済み → 有望 → 成約／失注）
tool_add_note	フォローアップ管理用の非公開メモをリードに追加します

---

📁 プロジェクト構成

indiamart-mcp-server/
├── 📄 mcp_server.py           ← SINGLE entry point
├── 📄 smithery.yaml            ← Smithery.ai marketplace manifest
├── 📄 pyproject.toml           ← Python package config
├── 📄 requirements.txt         ← MCP only (5 packages)
├── 📄 requirements-saas.txt    ← Web app deps
├── 📄 README.md                ← This file
├── 📄 CHANGELOG.md             ← Version history
├── 📄 LICENSE                  ← MIT License
├── 📄 .env.example             ← Annotated credential guide
├── 📄 .gitignore               ← Git ignore rules
├── 📄 docker-compose.yml       ← Full stack Docker setup
│
├── 📁 mcp_tools/               ← Core MCP Package
│   ├── __init__.py
│   ├── 🔧 tools.py            ← 10 MCP tools with rich docstrings
│   ├── 📋 schemas.py          ← Pydantic validation + response types
│   ├── 🌐 http_client.py      ← Resilient API client with retry
│   ├── 💾 database.py         ← SQLite operations
│   ├── 🔑 auth.py             ← API key helpers
│   └── 🐳 Dockerfile          ← MCP server Docker image
│
├── 📁 saas/                    ← SaaS Web App (FastAPI)
│   └── ...
│
├── 📁 tests/                   ← Test suite
│   ├── conftest.py             ← pytest fixtures
│   └── test_tools.py           ← Validation + integration tests
│
├── 📁 .github/                 ← CI/CD
│   └── workflows/ci.yml
│
└── 📁 docs/                    ← Documentation
    ├── tools.md
    └── examples.md

---

🔧 トラブルシューティング

「INDIAMART_API_KEY が設定されていません」

• .env.example だけでなく、.env ファイルを作成したことを確認してください
• キーが正しく、有効期限が切れていないことを確認してください
• .env ファイルがプロジェクトのルートディレクトリにあることを確認してください

Claude Desktop に IndiaMART ツールが表示されない

• Claude Desktop を完全に再起動してください（終了してから再度開きます）
• claude_desktop_config.json に構文エラーがないか確認してください（有効な JSON ですか？）
• cwd のパスが正しく、その場所に mcp_server.py が存在することを確認してください
• Claude Desktop のログで MCP 接続エラーを確認してください

日付形式のエラー

• 対応形式：YYYY-MM-DD、DD-MM-YYYY、DD/MM/YYYY、DD-Mon-YYYY
• 例：2026-01-15、15-01-2026、15-Jan-2026

---

📄 ライセンス

MIT License。ご自身のビジネスで自由にご利用ください。

---

🤝 コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature/my-feature
3. 変更をコミットします：git commit -m "Add my feature"
4. プッシュします：git push origin feature/my-feature
5. Pull Request を作成します

---

IndiaMART を利用するインドの販売者のために ❤️ を込めて開発