bol.com MCPサーバー：注文・出品・配送

💡 インストール不要？cloud.anythingmcp.comに直接アクセスして。 サインインし、Connectors → bol.comをクリックし、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerもgit cloneも、ローカルサーバーも不要です。

bol.com

オランダおよびベルギーのマーケットプレイス向けのbol.comリテイラーAPI: 注文、追跡可能な出荷、返品、FBB在庫、価格と在庫を含むオファー、手数料、カタログコンテンツ、競合オファー、評価、請求書、パフォーマンス指標。クライアントIDとシークレット。

セットアップ

セットアップには約3分かかります。bol.comのセラーアカウント（Verkopen via bol）と、bolセラーダッシュボードのAPI設定へのアクセスが必要です。コネクタにはリテイラーAPI用のクライアントIDとクライアントシークレットが必要です。

1. bolセラーダッシュボードでアカウントを開き、次にInstellingen → Diensten → API Instellingen（設定、サービス、API設定）を選択します。bolが技術的な連絡先を求めた場合は保存してください。
2. Client credentials voor de Retailer APIの下でAanmaken（作成）をクリックし、キーに名前を付けてToon secret（シークレットを表示）をクリックします。
3. client IDをBOL_CLIENT_IDに、secretをBOL_CLIENT_SECRETにコピーします。シークレットを失った場合は、新しい認証情報を作成してください。
4. コネクタをインストールします。接続を確認するためにbol_com_list_ordersを実行します: 自分で出荷するオープンな注文が返されます（FBR）。

クラウドと自己ホストは同じように機能します: 認証情報は同じで、登録するリダイレクトURLやIPアドレスはありません。

認証: コネクタはhttps://login.bol.com/token（クライアント認証情報）でクライアントIDとシークレットを交換し、約5分間有効なベアラートークンを取得し、期限が切れるまで再利用します。bolはログインサービスに過剰なリクエストを送るアドレスをブロックするため、毎回新しいトークンを要求することはありません。

どこから始めるか: bol_com_list_ordersはオープンなFBR注文を新しい順にリストします; bol_com_get_orderは顧客の出荷および請求の詳細とアイテムを追加します。bol_com_list_offersはあなたのオファーをリストし、bol_com_list_inventoryはbolがあなたのために保有している在庫（FBB）を表示します。

読み取る内容: 注文、輸送および追跡可能な出荷、理由と顧客コメントを含む返品、FBB在庫、価格、在庫および国の可用性を含むオファー、オファーが販売されていない理由、価格での商品の手数料、EANによるbolカタログコンテンツ、競合オファーと誰がバイボックスを持っているか、星評価、訪問数およびオファーごとのバイボックスの割合、週ごとのセラーのパフォーマンス指標、請求書（読み取り専用）。

出荷: bol_com_create_shipmentは自分で出荷するアイテムの出荷を確認し、キャリアと追跡コードを含みます。bol_com_add_track_and_traceは出荷に欠けているコードを追加します; 既存のコードを変更することはできません。

オファー: bol_com_create_offerおよびbol_com_update_offerはオファーを作成し、価格、在庫、履行、国または保留フラグを変更します。更新は指定されたフィールドのみを変更しますが、配列（バンドル価格、国）は古いものをすべて置き換えます。409は誰かが同時にオファーを変更したことを意味します。価格はVATを含むEURで、在庫は0から999です。

インストール時にオフになっている: bol_com_cancel_order_item（配達できない注文アイテムをキャンセル）およびbol_com_delete_offer（オファーを削除）。キャンセルは元に戻せず、セラーのスコアにカウントされ、削除されたオファーはbolから即座に消え、復元できません。オファーを一時停止するには、代わりにbol_com_update_offerで保留に設定します。AIがそれらを使用する必要がある場合にのみ、コネクタページでオンにしてください; AIはすべての変更を確認するように求めます。出荷、追跡、オファーの作成および更新はオンになっています。

非同期書き込み: 出荷、輸送およびキャンセルは結果の代わりにプロセスステータスで応答します。bol_com_get_process_status（またはbol_com_find_process_statusesをエンティティとイベントタイプで）で、SUCCESSまたはFAILUREの時点を表示します。bolはプロセスステータスを1日保持します。オファーは同期的です。

ページング: 注文、出荷、返品および在庫リストはpageを1から取り、1ページあたり50行を表示します; 空の応答はもうページがないことを意味します。オファーはカーソルを使用します: page.nextCursorを返し続け、欠落するまで続けます。

レート制限: bolはエンドポイントごとに設定します。注文リストと出荷リストは1分あたり25回の呼び出しを許可し、返品と在庫は1分あたり20回、請求書は1分あたり24回; 注文詳細は1秒あたり25回、オファーは1秒あたり25から50回です。429は秒単位のRetry-Afterを持ちます; ライブ値はapi.bol.com/retailer/public/ratelimitsで確認できます。

IDとフォーマット: 注文IDには文字（A4K8290LP0）を含むことができ、EANは文字列、日付はYYYY-MM-DD、時間はオフセット付きのISO 8601です。未使用のフィールドは省略され、bolは空の文字列に対して400を返します。

一般的なエラー: エラーはapplication/problem+jsonとして返され、title、detailおよびフィールド名を示すviolationsが含まれます。400は通常、フィールドが欠落または空であることを意味します。429はレート制限です: Retry-Afterの時間を待ってください。

カバーされていない内容: 返品の処理または登録（返品を受け入れるとbolが顧客に返金します）、配送ラベルの購入およびお金を動かすすべてのこと。

前提条件: BOL_CLIENT_ID, BOL_CLIENT_SECRET

コネクタをローカルにインストールする

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

http://localhost:3000/connectors/storeを開き、bol.comを選択し、前提条件に記載されている環境変数を貼り付けます。

利用可能なツール

例のプロンプト

• "今日出荷する必要があるオープンな注文はどれで、その中にキャンセルリクエストがあるものはありますか？"
• "顧客の住所とアイテムを含む注文A4K8290LP0を表示してください。"
• "私のオファーの中で販売されていないものはどれで、その理由は何ですか？"
• "EAN 8712345678901のバイボックスは誰が持っていて、価格はいくらですか？"
• "EAN 8712345678901の私のオファーの価格を24.95に、在庫を40に設定してください。"

次のステップ

• Claudeに接続する
• ChatGPTに接続する