click-search-mcp-server

Click Search と Claude を接続する MCP サーバーです。 会社名・法人番号・ドメインで企業情報を検索し、Claude が自然言語で回答できるようにします。

仕組み

[ユーザー] → [Claude] ←── MCP (stdio) ──→ [本サーバー] ──→ [Click Search]

1. ユーザーが Claude に「〇〇の会社情報を調べて」と依頼
2. Claude が MCP プロトコル経由で本サーバーのツールを呼び出す
3. 本サーバーが Click Search にログイン → 検索 → HTML パース
4. 構造化された企業情報を Claude に返却
5. Claude がユーザーに自然言語で回答

提供ツール

| ツール名 | 説明 | |---------|------| | click_search__company_search | 会社名・法人番号・ドメインで企業を検索（1日100回制限） | | click_search__company_detail_basic | 基本情報・区分・タグ・企業概要・インボイス情報 | | click_search__company_detail_news | 企業ニュース一覧 | | click_search__company_detail_departments | 組織図（部署名・電話番号） | | click_search__company_detail_personnel | 人事異動情報 | | click_search__company_detail_related | 関連会社情報 |

v0.2.0 以降の変更点: 単一の click_search__company_detail を 5 つのツールに分割し、トークン消費を最適化しました。同じ法人番号に対しては 60 秒間のメモリキャッシュが働くため、連続して複数のセクションを取得しても API 呼び出しは 1 回だけで済みます。

取得できる情報

company_detail_basic

• 基本情報（法人番号、住所、電話番号、代表者、設立、決算月、URL）
• 上場区分・業種
• 売上区分・従業員区分・資本区分
• 分野タグ・活動タグ
• 企業概要（AI 生成）
• インボイス登録番号・登録日・更新日

company_detail_news

• 日付・タイトル・URL 付きニュース一覧

company_detail_departments

• 部署名・代表電話番号

company_detail_personnel

• 氏名・役職・発表日

company_detail_related

• 関連会社名・法人番号

インストール

npm で公開済みです。ビルド不要でそのまま使えます。

ターミナルで以下のコマンドを実行するだけです：

claude mcp add --scope user click-search -- npx click-search-mcp-server -e CLICK_SEARCH_USER_ID=あなたのID -e CLICK_SEARCH_PASSWORD=あなたのパスワード

• あなたのID → Click Search のログイン ID に置き換えてください
• あなたのパスワード → Click Search のパスワードに置き換えてください

登録後、Claude Code を再起動すると MCP サーバーが自動的にロードされます。

/mcp コマンドで click-search · connected と表示されれば成功です。

ローカル開発

1. 依存関係のインストール

npm install

2. 環境変数の設定

cp .env.example .env

.env に Click Search のログイン情報を入力：

CLICK_SEARCH_USER_ID=your_user_id
CLICK_SEARCH_PASSWORD=your_password

3. ビルド

npm run build

使い方

Claude に自然言語で話しかけるだけです：

「サイバーエージェントの会社情報を調べて」
「法人番号 4011001034156 で企業を検索して」
「cyberagent.co.jp のドメインで会社を検索して」

Claude が自動的に検索 → 詳細取得の順にツールを呼び出します。

デバッグ

MCP Inspector で動作確認

npx @modelcontextprotocol/inspector node -- --env-file=.env dist/index.js

ブラウザで Inspector UI が開き、ツールを直接呼び出してテストできます。

単体テスト

node --env-file=.env dist/index.js

stderr にログが出力されます（MCP サーバーは stdout を使うため）。

技術詳細

• 認証方式: Cookie セッション（CLICKSRCSESSION）
• HTML パース: cheerio
• WAF 対応: PrimeWAF — 適切な User-Agent を設定
• セッション管理: 有効期限切れ時に自動再ログイン
• 検索制限: 1日100回（Click Search 側の制限）

プロジェクト構成

src/
├── index.ts      MCP サーバー本体 + ツール登録
├── auth.ts       ログイン・Cookie セッション管理
├── scraper.ts    HTML パース（cheerio）
└── types.ts      型定義

ブランチ運用

main        本番
└── staging テスト
    └── dev 開発 ← 現在のブランチ