ForHosting KIT · 意味で探す検索（セマンティック検索）

表記が違う同じ商品を突き合わせる

仕入先の「Wireless Mouse Blk 2.4G」と自社マスタの「ワイヤレス光学マウス黒」は同じ商品です。共通の品番がなくてもこうした組を見つけ、確認用の対応表を返します。使った分だけの支払いで、定額契約は不要です。

● 安定提供中件あたり$0.002

実行 — $0.002 + $0.0015/件 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

オンラインで実行

アカウントでログインし、当社のサーバー上で実行します。無料ツールはブラウザ内で動作しますが、これは上記の料金がKIT残高から差し引かれます。

この機能は、仕入れ先ごとに表記が異なる商品名や説明文を、意味の近さをもとに自動で突き合わせます。同じ商品を指しているのに文字列が一致しない商品マスタの名寄せに使います。

品番だけでは名寄せできない理由

仕入先のリストを自社の商品マスタに取り込んだことがある人なら、品番が合わず、仕入先ごとに商品名の書き方が違い、VLOOKUPでは表記が完全に同じ数件しか拾えないという苦労を知っています。UPCやEANなどのバーコード規格は理屈の上では商品の識別を解決しましたが、実際には仕入先が省いたり、独自コードを使ったり、色違いを少し違う説明で載せたりします。「Black」が「Blk」になる程度の揺れを読み解き、その奥の商品を見分ける必要があります。

使う場面と結果の見方

新しい仕入先の全商品の初回登録、毎週の価格・在庫の更新、三社の仕入先で同じ商品群の価格を比べるとき、買収した二つのカタログを統合するときなどに使います。結果は対応表として返り、確度の高い組はそのまま反映し、あいまいな組だけを人が確認します。本当に新しい商品は未対応のまま残るのが正しい動きです。確認リストを見ずにすべてを反映してしまうのがよくある失敗です。

表記ゆれは文字列の一致では解決しない

「ノートPC 13インチシルバー」と「13型ノートパソコン(シルバー)」は同じ商品を指していますが、文字列としては一致しません。仕入れ先ごとに表記のルールが違うため、単純な突き合わせでは同じ商品として認識できません。この機能は商品名や説明文の意味の近さで比較し、同一商品の候補を提示します。

最終判断は人が行う前提

この機能が返すのは、同一商品である可能性が高い候補とその関連度です。関連度が高い候補ほど一致している可能性が高くなりますが、最終的に同一商品として登録するかどうかの判断は担当者が行う前提です。

活用例

複数仕入れ先のカタログを1つの商品マスタに統合

卸売業者が、仕入れ先ごとに表記の異なる商品データを、この機能で突き合わせて1つの商品マスタにまとめています。

モール出品時の商品ページ照合

ECサイト運営者が、モールに出品する際、自社商品と既存の商品ページが同一かどうかをこの機能で確認しています。

店舗統合後の重複商品を洗い出す

小売業者が、店舗合併後に重複して登録された商品を、この機能で自動的に突き合わせて整理しています。

よくある質問

完全に同じ商品でなければ突き合わせできませんか？

表記が違っていても、意味の近さで同一商品の候補を提示します。完全一致は前提ではありません。

突き合わせの結果はそのまま自動反映されますか？

関連度の高い候補として提示するもので、最終的な登録の判断は担当者が行う前提です。

何件くらいまで突き合わせできますか？

件数の目安はありますが、大量の場合は複数回に分けて処理します。

商品画像も突き合わせの対象になりますか？

この機能は商品名や説明文といったテキストが対象です。画像の突き合わせには別の機能をご利用ください。

自社マスタに存在しない新商品はどう扱われますか？

無理に別の商品へ当てはめず、未対応のまま残します。確度の高い組はそのまま反映でき、あいまいな組は手早く確認できるよう印が付くため、作業は短い確認リストに絞られます。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/search/match-products

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/search/match-products \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"auriculares inalámbricos","candidates":["Auriculares Bluetooth","Teclado USB"]}'

const res = await fetch("https://api.kit.forhosting.com/search/match-products", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "query": "auriculares inalámbricos",
    "candidates": [
      "Auriculares Bluetooth",
      "Teclado USB"
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/search/match-products",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "query": "auriculares inalámbricos",
    "candidates": [
        "Auriculares Bluetooth",
        "Teclado USB"
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/search/match-products", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"query":"auriculares inalámbricos","candidates":["Auriculares Bluetooth","Teclado USB"]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"query":"auriculares inalámbricos","candidates":["Auriculares Bluetooth","Teclado USB"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/search/match-products", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "query": "auriculares inalámbricos",
  "candidates": [
    "Auriculares Bluetooth",
    "Teclado USB"
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "search.match_products",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

件あたり$0.0015

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

制限

`max_chunks`	10000
`max_tokens`	20000

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

向いている場面

複数の仕入れ先のカタログを1つの商品マスタに統合する場面や、モール出品時に自社商品と既存の商品ページを突き合わせる場面で使われます。

料金と使い方

基本料金$0.002に、突き合わせる商品1件ごとに$0.0015が加算されます。1,000件の商品カタログを突き合わせると$0.002+$0.0015×1000=$1.502です。

技術的な質問

料金はどう計算されますか？

基本$0.002に、商品1件ごとに$0.0015が加算されます。1,000件なら$1.502です。

日本語の商品名にも対応していますか？

対応しています。

KITの完全なドキュメントを見る →