ユースケース

米国の輸入記録から海外サプライヤーを探して調達に活かす

Q: 1 回の実行で何社まで返せますか？

1 回の実行で最大 200 社で、input の maxResults で指定します。それより大きな作業は、実行を複数回に分けてください。アカウントでは複数の実行を同時に進められます。

Q: サプライヤーだけ、または輸入業者だけを探せますか？

はい。type には any、supplier（海外の輸出業者）、company（米国の輸入業者）を指定できます。

米国税関の輸入記録から輸入業者と海外サプライヤーを検索し、出荷件数・日付・住所を JSON で取得。調達や営業のリサーチに使えます。

プリペイド、サブスクなしREST でも MCP でもモデル・データ・エージェントを 1 つのキーで

メーカーを探す方法には、紹介を頼む、展示会のリストをたどる、自分と同じ米国のバイヤーにすでに出荷している先を調べる、といったものがあります。最後の方法がいちばん直接的です。米国税関の記録には、どの海外サプライヤーが、どの輸入業者に、何をどれくらいの頻度で送っているかが載っているからです。Lovely Router はその記録を検索します。企業名または商品キーワードを送ると、企業 1 社につき JSON オブジェクトが 1 つ返り、料金はプリペイド残高から企業単位で支払います。調達用のスクリプト、CRM のジョブ、AI エージェントのどこからでも、1 つの API キーで呼び出せます。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

米国の輸入記録から海外サプライヤーを探して調達に活かす. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>

仕組み

競合または商品で検索する
競合の社名を使えばその供給元がわかり、商品キーワードを使えばその商品を出荷している企業がわかります。
フィルターと上限を付けてツールを実行する
クエリを POST /v1/tools/importyeti-companies/run に送ります。type は、海外の輸出業者なら supplier、米国の輸入業者なら company に設定します。minShipments と mostRecentShipment を使えば、取引が活発な相手だけに絞れます。
候補を絞って連絡する
出荷件数と直近の出荷日で並べ替え、安定して出荷しているサプライヤーを残して、通常の審査・見積もりのプロセスに進めます。

1 回のリクエストで輸入記録を検索する

米国の輸入記録を検索するは query を受け取り、1 回の実行で最大 200 社を返します。input の maxResults が上限です。この例では、キーワードに一致する、現在も取引のある海外サプライヤーを探します。

Shell

curl https://lovelyrouter.com/v1/tools/importyeti-companies/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "query": "anker",
      "type": "supplier",
      "mostRecentShipment": "12mo",
      "minShipments": 5,
      "maxResults": 20
    },
    "max_results": 20
  }'

各結果は、出荷データを持つ企業です。searchType を使えば、名前での検索から住所での検索に切り替えられます。60 秒を過ぎても実行中の場合は 202 が返ります。ポーリングの方法はツールを実行するをご覧ください。

各企業に含まれるもの

フィールドグループ	取得できる内容
企業	輸入業者とその海外サプライヤー
出荷	出荷件数と日付
所在地	住所
ブランド	商標

記録は米国税関への申告に基づくため、対象は米国向けに出荷された商品です。

レシピ

競合の供給元を調べる。

type を company にして競合を社名で検索し、サプライヤーを確認して、出荷が安定している先に見積もりを依頼します。

商品ごとのサプライヤーリストを作る。

type を supplier、minShipments を 10 にして商品キーワードを検索すれば、まとまった量を出荷している輸出業者だけが表示されます。

休眠中のサプライヤーを外す。

mostRecentShipment を 6mo にすると、出荷が止まった工場がリストに入りません。

販売先の輸入業者を探す。

梱包材、物流、ソフトウェアなどを販売しているなら、商品カテゴリで company の記録を検索し、出荷件数の多い輸入業者を見込み客にします。

住所で検索する。

searchType に addresses を指定すると、倉庫やオフィスの住所を共有している企業がわかります。

普段の言葉で頼みたい場合は、MCP サーバーを接続して Claude Code や Cursor に次のように伝えます。「米国の輸入記録から、過去 12 か月以内に出荷があり、出荷件数が 5 件以上の『silicone kitchen tools』のサプライヤーを検索してください。直近の出荷日を付けて 25 社返してください。maxResults と max_results は 25 にしてください。」