Developers & AI Agents

API ドキュメント

DistyMap（ディスティマップ）のデータは REST API・MCP サーバー・llms.txt の3形態で提供しています。
5363 メーカー・14524 代理店を収録。

REST API

ChatGPT GPTs や任意のエージェントから利用できる JSON API。匿名利用は低クォータ・一部情報制限つきで、APIキー利用はプラン別クォータで詳細レスポンスを返します。

APIキー

本格利用・AI連携・社内システム連携では X-API-Key または Bearer トークンを付与してください。

curl -H "X-API-Key: dmp_xxx" https://distymap.com/api/manufacturers?q=ROHM

API・MCP・データ利用には利用規約が適用されます。大量利用、再配布、AI学習利用は別途契約が必要です。

GET /api/manufacturers

メーカー名（表記ゆれ可）から代理店一覧を検索します。

パラメータ

q	必須	メーカー名（アルプス電気、Alps Alpine など表記ゆれ可）
category	任意	distributor / catalog / sales_rep / online / limited（販売形態。証跡の強さは evidence_level）
territory	任意	テリトリー（前方一致）

GET /api/manufacturers?q=Alps+Alpine&category=catalog

GET /api/distributors

代理店名から取扱メーカー一覧を検索します。

GET /api/distributors?q=DigiKey

POST /api/match

メーカー名のリストを一括で正規名に名寄せし、代理店数と証跡の内訳（both / official / distributor_only）を返します。BOM・見積依頼・取引先一覧の下処理向け。行の順序は入力と同じ。1 回に 100 件まで（匿名は 20 件）。GET 版はカンマ・改行区切りの names パラメータ。ブラウザからは /search で同じ処理を表と CSV で受け取れます。

POST /api/match
{"names": ["アルプス電気", "ＴＤＫ", "樫山工業"]}

GET /api/normalize

メーカー名の表記ゆれを正規名に変換します。信頼度（exact / partial / none）を返します。

alias_kind で一致の性質を判別できます。 notation は「テキサス・インスツルメンツ → Texas Instruments」のような表記の違い、 former は「東芝 → 東芝デバイス&ストレージ」のような社名変動を表します。後者だけを社名変更として扱いたい場合は is_name_change を見てください。同名の別名が複数社にある場合は ambiguous: true となり、 exact でも自動採用の前に確認が必要です。

match_type は一致の仕方を表します。 literal は文字列がそのまま一致、 normalized は法人格・記号・大文字小文字を除いて一致（「(株)村田製作所」など）。どちらも confidence: exact です。

引いたメーカー自身が他社へ統合されている場合は succeeded_by に統合先が入ります。「KEMET」は KEMET として解決されますが、現在は Yageo 傘下である、といった場合です。

GET /api/normalize?name=アルプス電気

{
  "input": "アルプス電気",
  "canonical_name": "アルプスアルパイン",
  "matched_alias": "アルプス電気",
  "confidence": "exact",
  "alias_type": "former_name",
  "alias_type_label": "旧社名",
  "alias_kind": "former",
  "alias_kind_label": "旧社名・統合前社名",
  "is_name_change": true,
  "ambiguous": false,
  "alternatives": []
}

GET /api/search

メーカーと代理店を横断検索します。ライブサーチ・オートコンプリートに最適です。

GET /api/search?q=Alps

カテゴリ体系

代理店の売り方を 5 種に標準化しています。「正規かどうか」はこの軸ではなく、下の証跡（evidence_level）で表します。

ID	名称	説明
distributor	代理店	メーカー製品を取り扱う代理店（正規・一般を統合）。
catalog	カタログ通販	DigiKey・Mouser・Arrow・RS・コアスタッフ・TME など大手カタログ通販。
sales_rep	セールスレップ	メーカーの販売代理人。引き合いの窓口で、在庫を持って売る代理店とは別。
online	オンラインショップ	上記以外の Web／通販ショップ。
limited	限定代理店	EOL・廃番品専門、軍需・航空宇宙専門、独立系など条件付きの代理店。

証跡（evidence_level）

関係ごとに「誰がそう書いているか」を出典URLつきで持ち、その強さを 1 語で返します。現在の内訳: 両面確認 4,667 / メーカー公式のみ 27,484 / 代理店側の掲載のみ 58,908 件。 AI から使うときは evidence_level を添えて答え、distributor だけの関係を「正規代理店」と言い切らないでください。

evidence_level	意味
both	メーカー公式の代理店一覧と、代理店側の取扱メーカー掲載の両方で確認（両面確認）。最も強い
official	メーカー公式サイトの代理店一覧に掲載
catalog	カタログ通販のブランドページなどで確認
distributor	代理店が自社サイトの取扱メーカー索引に載せているだけ（当事者の自己申告。公式一覧より弱い）
unknown	出典の素性が確認できていない

レスポンスでは各行の sources[]（source_url / source_type）と official_listing_count（その代理店をメーカー公式一覧に載せているメーカー数）、メーカー側の sales_model（direct=直販）・no_public_list_at（公式に一覧が無いと確認した日）で根拠を辿れます。日本法人には corporate_number（国税庁の法人番号）を付けており、/corporate/{13桁} で社名の表記に依らずページに辿り着けます。代理店網の変化は /updates.atom（メーカーごとは /manufacturers/{code}/updates.atom）で購読できます。

MCP サーバー

Claude / ChatGPT / Cursor などの MCP 対応クライアントに URL を登録するだけで、インストール無しで使えます。エンドポイントは https://distymap.com/mcp（Streamable HTTP）。 API キー無しでも使えますが REST API の匿名利用と同じ絞り（10 件・連絡先非表示・120 回/時）です。 Authorization: Bearer dmp_xxx を付けると全件返します。

Claude Code

claude mcp add --transport http distymap https://distymap.com/mcp \
  --header "Authorization: Bearer dmp_xxx"

Cursor / Claude Desktop（Connectors）/ ChatGPT

{
  "mcpServers": {
    "distymap": {
      "url": "https://distymap.com/mcp",
      "headers": { "Authorization": "Bearer dmp_xxx" }
    }
  }
}

Claude Desktop はカスタムコネクタとして URL を追加します。手元で動かす場合は uv run distymap-mcp（stdio）も引き続き使えます。

利用可能なツール

search_distributors_by_manufacturer

メーカー名から代理店を検索（evidence_level・出典つき、証跡の強い順）

search_manufacturers_by_distributor

代理店名からメーカーを検索

match_manufacturers

メーカー名のリストを一括で正規名に名寄せ（BOM・見積依頼の下処理。100 件まで、匿名は 20 件）

normalize_manufacturer_name

表記ゆれを正規名に変換

get_company_group

会社の所属グループ（親会社・グループ会社）と登記の閉鎖を出典つきで返す

list_categories

販売形態の一覧を返す

get_stats

データ統計（証跡の内訳・テリトリー記載率）を返す

llms.txt

Perplexity・Google AI Overviews 向けの構造化テキスト。LLM がこのサービスの概要・API・カテゴリ体系を理解するために使用します。

/llms.txt を開く ↗

OpenAPI 仕様

ChatGPT GPTs への登録や、任意のクライアントコード生成に利用できます。

openapi.json をダウンロード ↗ Swagger UI で試す ↗