Developers & AI Agents

API ドキュメント

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

REST API

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

APIキー

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

curl -H "X-API-Key: dmp_xxx" https://<このサイトのドメイン>/api/manufacturers?q=ROHM

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

GET /api/manufacturers

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

パラメータ
q 必須 メーカー名(アルプス電気、Alps Alpine など表記ゆれ可)
category 任意 authorized / distributor / catalog / online / reseller
territory 任意 テリトリー(前方一致)
GET /api/manufacturers?q=Alps+Alpine&category=authorized
GET /api/distributors

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

GET /api/distributors?q=DigiKey
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段階に標準化しています。

ID 名称 説明
distributor 代理店 メーカー製品を取り扱う代理店(正規・一般を統合)。
catalog カタログ通販 DigiKey・Mouser・Arrow・RS・コアスタッフ・TME など大手カタログ通販。
online オンラインショップ 上記以外の Web/通販ショップ。
limited 限定代理店 EOL・廃番品専門、軍需・航空宇宙専門、独立系など条件付きの代理店。

MCP サーバー

Claude Desktop から接続してツールとして利用できます。 uv がインストールされていれば追加依存不要です。

claude_desktop_config.json への追記
{
  "mcpServers": {
    "distymap": {
      "command": "uv",
      "args": ["run", "distymap-mcp"]
    }
  }
}
利用可能なツール
search_distributors_by_manufacturer
メーカー名から代理店を検索
search_manufacturers_by_distributor
代理店名からメーカーを検索
normalize_manufacturer_name
表記ゆれを正規名に変換
list_categories
カテゴリ一覧を返す
get_stats
データ統計を返す

llms.txt

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

OpenAPI 仕様

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