本文へスキップ

API

開発者向け

ERP、倉庫、生産システムとの連携、およびエージェントやスキャナー向けの製品データを提供する Itemoo 公開 API です。ドキュメントはリクエストを処理するコードそのものから生成されるため、API とずれることはありません。

3 分で最初の呼び出し

  1. Itemoo ダッシュボードで「連携 → API キー」を開き、必要なスコープでキーを作成します。キーは一度しか表示されません。

  2. 接続の確認:ヘッダー Authorization: Bearer itm_… を付けて GET /v1/ping

  3. 在庫を送信するか注文を取得します。以下の各エンドポイントに例があります。注文通知はダッシュボードの同じ場所で設定します。

ダッシュボードでキーを作成 →

cURL

curl 'https://itemoo.eu/v1/ping' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

AI アシスタント向け MCP サーバー

Model Context Protocol により、AI アシスタント(Claude、ChatGPT など)は個別の連携開発なしで Itemoo を利用できます。アシスタントがツールとパラメーターを自ら見つけます。

グローバル MCP — 製品と購入

製品、ブランド、企業、販売店、記事の検索、各情報の出典付きの製品データ、リコール、文書、決済リンク付きのカート。ログイン不要です。検索対象は掲載に同意したブランドのみで、支払いは常にブランドのショップで行われます。

サーバーアドレス

https://itemoo.eu/mcp

ツール

  • search — Search products, brands, companies, sellers and articles
  • brand_get — Brand profile
  • product_lookup — Product data with provenance
  • recall_status — Recall and safety notice status
  • documents_list — Product documents
  • sellers_for_product — Where to buy
  • cart_create — Prepare a cart in a brand shop

ブランド MCP — 貴社ブランドのデータ

カタログ、ロット、スキャン、コンプライアンス上の不足、売上と在庫の数値 — 顧客の個人データは含みません。ブランドオーナーが別途同意すると、アシスタントは商品ページ、投稿、記事、キャンペーン、ブランドサイトの下書きも作成します。公開は必ず人がパネルで行います。各接続はチームの 1 人と 1 つのブランドに属します。

貴社ブランド:アドレスはパネルに表示

https://itemoo.eu/mcp/b/{brand}

  1. ブランドのオーナーがパネルの「連携 → AI アシスタント (MCP)」で有効にし、接続できるロールを選びます。

  2. アシスタントに、パネルに表示されたブランドのサーバーアドレスでカスタムコネクターを追加します。

  3. Itemoo にログインしてアクセスを承認します。アシスタントはロールで許可された範囲だけを参照でき、接続はパネルで取り消せます。

ツール

  • products_list — Products of the brand
  • products_get — Product details
  • batches_list — Batches (LOT)
  • codes_stats — QR code and unit statistics
  • scans_analytics — Scan analytics
  • plan_usage — Plan and usage
  • catalog_gaps — Catalogue gaps
  • translations_status — Translation status
  • orders_summary — Orders summary
  • customers_summary — Customers summary
  • stock_overview — Stock overview
  • promotions_list — Promotions
  • marketplace_status — Marketplace channels
  • team_overview — Team overview
  • billing_summary — Billing summary
  • product_page_get — Product page draft for editing
  • product_draft_create — Create product drafts
  • product_page_draft_patch — Edit a product page draft
  • site_draft_get — Brand website draft
  • site_draft_patch — Edit the brand website draft
  • publications_list — Social media posts
  • publication_get — One post
  • publication_draft_upsert — Create or edit a post draft
  • articles_list — Knowledge articles
  • article_get — One article
  • article_draft_upsert — Create or edit an article draft
  • campaigns_list — Push and newsletter campaigns
  • campaign_get — One campaign
  • campaign_draft_upsert — Create or edit a campaign draft
  • draft_discard — Discard your own draft

cURL

curl -X POST 'https://itemoo.eu/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"resin"}}}'

ガイド

ステップごとに解説:ERP の接続、Webhook、製品パスポート。

ガイドは近日公開予定です。