한국 크림 2개 구성: 본품 120mL와 별도 증정 표시 구분

This is a predefined example, not your purchase selection. Example lookups carry the diagnostic header and are excluded from non-diagnostic acquisition counts. / 미리 정한 예제이며 실제 구매자의 선택이 아닙니다. 실행은 진단 요청으로 구분합니다.

국가·통화·옵션·단위로 구매 질문 찾기 / Find a buying question · Question directory JSON

상품을 고를 때 하다카트를 사용하는 방법 / Use a buying task

단순 상품 목록 대신 묶음 단위나 정확한 옵션 조건을 비교하세요. 기존에 연결한 하다카트 도구에서 아래 요청을 사용할 수 있습니다. 공개 API는 로그인 없이 읽을 수 있으며, MCP 연결·권한은 사용하는 클라이언트에서 별도로 설정합니다.

실행 가능한 요청과 동일 근거 JSON · Markdown · OpenAPI

MCP endpoint: https://hadacart.tiny-deer-9667.chatgpt.site/mcp. 연결은 전체 AI 사용자에게 자동 배포되는 것을 뜻하지 않습니다.

Public MCP input recovery / 조회 오류 수정

Tool errors keep isError=true and return structuredContent.error plus structuredContent.recovery. These are documentation only; no input was changed or retried. 예시는 실제 구매자의 국가·옵션·예산 또는 결제 동의가 아닙니다.

Call tools/list for the current input schema. Do not repeat the same failing request unchanged.
find_purchase_candidates requires query, one native currency and destinationCountry. Use the actual buyer destination; US additionally needs the actual region to assess a purchase handoff.
optionQuery and maxOptionPrice require sellerId and one native currency, even when productId is provided. Preserve the exact option, quantity, budget, benefits and product constraints. Never remove them just to obtain a result.
For get_product, copy an exact products[].id from search_products or candidates[].productId from find_purchase_candidates. A title, variant ID, merchant URL or invented prefix is not a product ID. Unknown IDs are not replaced automatically.
If required buyer choices are missing, obtain them from the buyer. The KR and US examples below are diagnostic documentation, never defaults or buyer consent.
After correcting the input, review source dates, exact options and destination conditions. Keep the original issued affiliate URL and reselect actual options/quantity at merchant; delivery, final total, payment approval, qualified order and commission need separate evidence.

Diagnostic examples only: send X-Hadacart-Traffic-Purpose: diagnostic when testing. / 테스트 예제는 진단 요청으로 구분합니다.

[
  {
    "label": "KR native-KRW udon example only",
    "tool": "find_purchase_candidates",
    "arguments": {
      "query": "우동",
      "currency": "KRW",
      "destinationCountry": "KR",
      "sellerId": "pulmuone",
      "quantity": 1,
      "limit": 3
    }
  },
  {
    "label": "US native-USD exact K2 Brown example only; NY and quantity2 are not buyer defaults",
    "tool": "find_purchase_candidates",
    "arguments": {
      "query": "K2",
      "currency": "USD",
      "destinationCountry": "US",
      "destinationRegion": "NY",
      "sellerId": "keychron",
      "productId": "keychron-4328395079769",
      "optionQuery": "Brown",
      "quantity": 2,
      "budget": {
        "amount": 140,
        "currency": "USD"
      },
      "maxOptionPrice": 70,
      "limit": 3
    }
  }
]

Run a Korean or US catalog example

Download and inspect the Node.js example. In a separate local directory, install the pinned SDK dependency and choose one fixed diagnostic task.

npm install --save-exact @modelcontextprotocol/client@2.3.1
node public-catalog-client.mjs kr
node public-catalog-client.mjs us

Own integration check: 2026-10-19T18:42:26.758Z; @modelcontextprotocol/client@2.3.1; Node v26.5.0; negotiated MCP 2025-11-25. Initialization and notification are handled by the SDK. Optional GET subscription returns405 on this stateless server. Both KR/US candidate requests succeeded without credentials; other clients/versions remain unverified.

KR retains welcome-deal conditions. US retains K3P-H3, NY/USD/quantity1 and ceilings, including the dated unavailable flag and no preparation plan. Output includes original source times, issued links and unknown delivery/final totals.

All sample requests are diagnostic. These fixed tasks do not represent buyer choices or consent; no affiliate link is followed, cart created or payment authorized. For a real lookup supply actual buyer constraints in your own client. Keep sample runs out of acquisition and revenue evidence.

Public read-only catalog MCP

Official MCP Registry metadata listing: com.hadacart/catalog-snapshots 1.0.0 · active · published 2026-10-21T01:22:49.120624Z · verified 2026-10-21T01:23:02.651Z. This records metadata, not endorsement, client installation, buyer traffic, orders or commission.

https://hadacart.com/api/catalog/mcp

Use this Streamable HTTP endpoint to read public Korean and US product snapshots without the personal plugin. Configure it in your authorized client, omit Authorization and Cookie, and send no API keys or personal data. Specify the actual buyer country, native currency, exact product/option, quantity and budget.

Only find_buying_guides, find_purchase_candidates, search_products and get_product are exposed. Integration tests use X-Hadacart-Traffic-Purpose: diagnostic. Client setup and network permissions remain separate.

No connected apps, private reports, merchant refresh, affiliate activation, cart, checkout, payment or order tools. Native Sites OAuth remains separate. Registry metadata publication does not establish universal client compatibility, automatic distribution, a buyer or commission.

Connection JSON / Protocol request example

연결 경로 / Supported connection paths

계정 없이 읽는 공개 후보 조회는 https://hadacart.com/api/buying/candidates에 POST하고 쿠키·인증 정보를 보내지 않습니다. 국내·미국 상품 모두 실제 국가·통화·옵션·수량을 지정하세요.

MCP는 Sites가 제공한 https://hadacart.tiny-deer-9667.chatgpt.site/mcp와 별도 클라이언트 연결·권한을 사용합니다. 기존 연결의 읽기만 확인했으며 모든 AI 사용자에게 자동 배포되거나 익명 클라이언트가 동작한다고 확인하지 않았습니다.

하다카트 도메인의 원시 /mcp 익명 POST는 마지막 검사에서404였습니다. 원인은 확정하지 않았습니다. 공개 조회는 검증된 HTTP 경로를 사용하고 기존 OAuth·접근 권한을 유지하세요.

엔드포인트·OAuth 리소스·실제 확인 시각 JSON

다른 AI 클라이언트에서 공개 API 사용 / Public HTTP integration

개인 플러그인을 설치하지 않은 브라우저·서버 에이전트도 공개 후보 조회 API를 직접 사용할 수 있습니다. 사용하는 클라이언트의 도구 설정·네트워크 허용은 별도이며 전체 AI 사용자에게 자동 배포되는 것은 아닙니다.

const response = await fetch("https://hadacart.com/api/buying/candidates", {
  method: "POST",
  credentials: "omit",
  headers: {"Content-Type": "application/json", "X-Hadacart-Traffic-Purpose": "diagnostic"},
  body: JSON.stringify({
  "query": "",
  "productId": "naturerep-14486",
  "sellerId": "naturerep",
  "currency": "KRW",
  "destinationCountry": "KR",
  "quantity": 1,
  "unit": "mL",
  "referenceQuantity": 100,
  "limit": 1
})
});
if (!response.ok) throw new Error("Hadacart returned HTTP " + response.status);
const shortlist = await response.json();

이 코드는 연결 검사 예시입니다. diagnostic 헤더는 자체 검사를 구분합니다. 실제 구매자 조회에서는 해당 헤더를 생략하고 국가·조건을 구매자 선택으로 바꾸세요. 쿠키·비밀키·카드·개인 주소·이메일을 보내지 않습니다. 결과의 원본 제휴 링크 반환은 링크 이동·장바구니·주문·수수료가 아닙니다.