開発者向け情報

In English

DTMFRAME publishes Japanese music-production products (plugins and gear), their current shop prices and running sales. Read-only; no account, no authentication.

• MCP: https://dtmframe.com/mcp/ (Streamable HTTP, stateless). Tools: search_products, get_current_offers, resolve_purchase_request, compare_products, list_deals.
• REST and OpenAPI: https://dtmframe.com/api/v1/openapi.json
• Limits per client: 60 reads and 10 computations per minute.
• Responses carry no affiliate tracking links. The shop links, the full price table of every shop and the advertising disclosure are on the page each response names as canonical_page (and site_entry_page).
• Terms · Privacy · llms.txt

エンドポイント

• OpenAPI：/api/v1/openapi.json（zodスキーマから生成）
• REST（読み取り）：GET /api/v1/products/、GET /api/v1/products/%7Bid%7D/offers/、GET /api/v1/deals/
• REST（計算）：POST /api/v1/resolve/、POST /api/v1/compare/（JSON本文、32KiBまで、応答は常にno-store）
• MCP：POST /mcp/（Streamable HTTP・無状態・JSON応答。GET/DELETEは405。batch配列は-32600で拒否）
• MCPのinitializeが返すserverInfo：name = dtmframe、title = DTMFRAME、version = 0.1.0（nameは公開ブランドから導いた安定識別子で、内部パッケージ名ではありません）

`tools/list` が返すのは次の5本だけです：search_products get_current_offers resolve_purchase_request compare_products list_deals

AI 向けのサイト案内：/llms.txt。Claude で使うときは Claude に追加（追加の前に Claude の画面で確認があります）。

利用上限の区分（接続元ごと・60秒窓）

本文は32768バイトまで（超過は413）。応答は1048576バイトまで。同時処理は32件。超過時は429または503とRetry-Afterを返します。

引き継ぎリンク

• すべてのリンクはhandoff_mode=user_navigationです。人が選んで遷移する前提で、prefetchや自動クリックは案内しません。
• canonical_pageは常にパラメーターなしの正規URLです。entry=api / entry=mcp付きの入口はpermitted_handoff_links[kind=site_entry_page]として別に返します。
• 販売店の通常URL（merchant_plain）は、取得元の権限が当該チャネルへのリンク配布を許す場合だけ含めます。承認済みで、追跡リンクの雛形があり、web だけに許された提携の店舗の出品には、通常URLも付けません（省いたことは応答に示します）。未承認の提携の店舗は、通常URLがそのまま付きます。機械向け追跡URLは返しません。
• すべての応答に、当サイトの製品ページへの入口（site_entry_page）が付きます。購入先へのリンクと全販売店の価格表、広告関係の表示はそのページにあります。

search_products

例：GET https://dtmframe.com/api/v1/products/?category=mastering_limiter_plugin&limit=20

要求パラメーター（GETのクエリ・MCPのarguments）

未知のキーは400で拒否します。aliasは表記正規化のうえ別名辞書へ完全一致し、解決できない場合は0件とunresolved_constraints=["alias_unresolved"]を返します（値は記録しません）。

応答（封筒 + products[] + next_cursor）

MCP入力スキーマ（tools/listと同一）

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "daw",
        "instrument_plugin",
        "effect_plugin",
        "mastering_limiter_plugin",
        "mastering_suite",
        "restoration",
        "sample_library",
        "ai_separation",
        "ai_restoration",
        "ai_composition",
        "ai_voice",
        "audio_interface",
        "microphone",
        "headphones",
        "studio_monitor",
        "guitar",
        "bass",
        "keyboard",
        "synthesizer",
        "electronic_instrument",
        "pedal",
        "multi_effect",
        "amp_simulator",
        "dj_controller",
        "dj_player",
        "dj_mixer",
        "midi_controller",
        "accessory",
        "computer",
        "computer_peripheral"
      ]
    },
    "brand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "product_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "alias": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "format": {
      "type": "string",
      "enum": [
        "vst2",
        "vst3",
        "au",
        "aax",
        "clap",
        "standalone"
      ]
    },
    "os": {
      "type": "string",
      "enum": [
        "macos",
        "windows",
        "linux",
        "ios",
        "android"
      ]
    },
    "license": {
      "type": "string",
      "enum": [
        "perpetual",
        "subscription",
        "rent_to_own",
        "free",
        "trial",
        "unknown"
      ]
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "additionalProperties": false
}

get_current_offers

例：GET https://dtmframe.com/api/v1/products/%7Bproduct_id%20%7C%20slug%20%7C%20edition_id%7D/offers/?region=JP

要求パラメーター

応答（封筒 + offers[] + offers_coverage + field_availability + withheld_fields）

取得元との契約で当該チャネルへ出せない値はwithheld_by_channel_policyとして示し、推定で埋めません。並び順は全チャネル共通で、報酬額は使いません（同じ価格・条件の店は提携している店を先に並べます）。

MCP入力スキーマ

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "region": {
      "default": "JP",
      "type": "string",
      "enum": [
        "JP",
        "US",
        "EU",
        "GB",
        "GLOBAL"
      ]
    },
    "condition": {
      "type": "string",
      "enum": [
        "new",
        "used",
        "refurbished",
        "unknown"
      ]
    }
  },
  "required": [
    "product_id"
  ],
  "additionalProperties": false
}

MCP呼び出し例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_current_offers",
    "arguments": {
      "product_id": "{product_id}",
      "region": "JP"
    }
  }
}

応答はcontent[0].text（JSON文字列）とstructuredContentの両方に、RESTと同一の封筒と本文をresponse_channel: "mcp"で返します。

list_deals

開催中・開始前のセールの一覧です。例：GET https://dtmframe.com/api/v1/deals/?limit=20

要求パラメーター（GETのクエリ・MCPのarguments）

応答

MCP入力スキーマ

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "brand": {
      "description": "Brand slug as on /brands/{slug}/ (the manufacturer_id from search_products is accepted too).",
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[a-z0-9][a-z0-9_-]{0,127}$"
    },
    "category": {
      "description": "Category slug as on /categories/{slug}/, e.g. audio-interface (the search_products spelling audio_interface is accepted too).",
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-z0-9][a-z0-9_-]{0,127}$"
    },
    "kind": {
      "description": "Campaign kind.",
      "type": "string",
      "enum": [
        "sale",
        "giveaway",
        "purchase_bonus",
        "coupon",
        "bundle_change",
        "cashback",
        "upgrade_offer",
        "seasonal_feature"
      ]
    },
    "source": {
      "description": "official = manufacturer store, merchant = reseller or marketplace listings, announcement = manufacturer announcement without listings.",
      "type": "string",
      "enum": [
        "official",
        "merchant",
        "announcement"
      ]
    },
    "state": {
      "default": "running",
      "description": "running (default) = active, ending_soon or stale; ending_soon; scheduled; all = every state including ended campaigns.",
      "type": "string",
      "enum": [
        "running",
        "ending_soon",
        "scheduled",
        "all"
      ]
    },
    "limit": {
      "default": 20,
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "cursor": {
      "description": "Opaque next_cursor of the previous page (bound to one published snapshot).",
      "type": "string",
      "minLength": 1,
      "maxLength": 256
    }
  },
  "additionalProperties": false
}

resolve_purchase_request（計算）

例：POST https://dtmframe.com/api/v1/resolve/

{
  "schema_version": "1.1",
  "mode": "find_product",
  "constraints": {
    "budget": {
      "amount_minor": 50000,
      "currency": "JPY"
    },
    "daw": "logic-pro",
    "experience": "beginner",
    "category": "mastering_limiter_plugin"
  },
  "ownership_claims": [],
  "max_candidates": 3
}

三モード（find_product / build_setup / improve_setup）の条件付き提案を計算します。自由文・予算・お持ちの製品の入力・個別価格はPOST本文だけで受け取り、URL・アクセスログ・エラー記録に入れません。お持ちの製品の入力が空のときはownership_state=not_provided（「何も所有していない」とは扱いません）。計算は固定サイズの計算worker（2 worker・待ち行列16・実行期限1秒・待機期限2秒）で行い、飽和時は503（compute_busy）、期限超過で検証済みの途中案が無いときは504（compute_deadline）を返します。途中案がある場合はsearch_complete=false / optimality_scope=best_foundで返します。

要求本文（上位キー）

constraints

応答（封筒 + candidates[] + unpriced_candidates[]）

MCPのtools/callでは同じ本文をargumentsに入れます。応答はresponse_channel: "mcp"以外RESTと同一です（AC-15）。web限定の販売条件はどちらにも含まれません。

compare_products（計算）

例：POST https://dtmframe.com/api/v1/compare/（edition_ids 2〜10件）

エディションごとのライセンス・形式・OS・機能・最安既知費用・予算区分とdiffering_fieldsを返します。制限と費用区分はresolve_purchase_requestと同じです。