概要
出荷業者向けのUSPS API:米国の住所を検証し、ZIPコードを検索し、国内および国際価格を比較し、配達日と配送オプションを取得し、荷物を追跡し、郵便局、ドロップオフサイト、パーセルロッカーを見つけます。ラベル、払い戻し、ピックアップ、SCANフォームが含まれていますが、オフになっています。USPSカスタマーオンボーディングポータル内のアプリのコンシューマキーとシークレット。
ガイド付きセットアップ
USPS を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで USPS を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
USPS のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → USPSをクリックし、資格情報を貼り付け、MCP APIキーを作成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
USPS
出荷業者向けのUSPS API:米国の住所を検証し、ZIPコードを検索し、国内および国際価格を比較し、配達日と配送オプションを取得し、荷物を追跡し、郵便局、ドロップオフサイト、パーセルロッカーを見つけます。ラベル、払い戻し、ピックアップ、SCANフォームが含まれていますが、オフになっています。USPSカスタマーオンボーディングポータル内のアプリのコンシューマキーとシークレット。
セットアップ
セットアップには約15分かかります。
- https://cop.usps.com/cop-navigator?wf=API でUSPSカスタマーオンボーディングポータルを開き、USPSビジネスアカウントでサインインするか、そこで新しいアカウントを作成します。このポータルはUSPS API用にアカウントを準備します。
- ポータルの上部でMy Appsを選択し、アプリを追加します。
- アプリを開き、CredentialsでConsumer Keyを
USPS_CLIENT_IDに、Consumer SecretをUSPS_CLIENT_SECRETにコピーします。 USPS_API_HOSTでAPIアドレスを選択します:本番環境https://apis.usps.com、またはメール業者用のテスト環境https://apis-tem.usps.com。どちらも同じ本番資格情報を使用します。テストホストで作成されたラベルには透かしが入り、料金は発生しません。USPSは追跡を除くすべてのAPIに対してテストホストを公開していますので、主に追跡を行う場合は本番環境を使用してください。- オプションとして、ラベルと契約価格用に、
USPS_CRID、USPS_MID、USPS_EPS_ACCOUNT_NUMBERにそれぞれあなたのCRID、メール業者ID、エンタープライズ支払いアカウント番号を入力します。あなたのビジネスカスタマーゲートウェイアカウントのビジネスサービス管理者がそれらを持っています。
コネクタは選択したホストの/oauth2/v3/tokenにコンシューマキーとシークレットを送信し(クライアント資格情報)、約8時間有効なベアラートークンを取得します。このトークンは再利用され、自動的に更新されます。
新しいアプリが使用できるもの:すべてのアプリはUSPSのデフォルト製品から始まります:OAuth、住所、国内価格、国際価格、ロケーション、サービス基準、配送オプション、追跡。したがって、住所、価格、配達日、配送オプション、追跡、郵便局、ドロップオフロケーションはすぐに機能します。キャリアピックアップ、支払い、ラベル、国際ラベル、SCANフォームはUSPSの承認が必要です:USPS APIサービスリクエストをEmail Usページ(https://emailus.usps.com/s/usps-APIs)から依頼してください。ラベルAPIは、**USPS Ship**(発送および返送ラベル)への登録と、郵便料金を支払うエンタープライズ支払いアカウント(EPS)が必要です。パーセルロッカー(usps_find_parcel_lockers)と国際サービス基準(usps_get_international_service_standard)には独自のスコープがあります。もし403が返された場合は、同様にUSPSに依頼してください。
始める場所:usps_get_city_stateを使用してZIPコードで接続を確認します。見積もりには、usps_search_shipping_optionsがすべてのサービスの価格と配達日を1回の呼び出しで返します。usps_search_domestic_pricesとusps_search_international_pricesは、追加サービスを含む価格の内訳を提供します。
住所:usps_validate_addressは米国の住所を標準化し、ZIP+4、DPVConfirmation(Yは確認済み、Dは二次番号が欠落、Sは二次番号が未確認、Nは未確認)、business(YまたはN)、およびvacantを返します。usps_get_zip_codeは都市と州のストリートのZIPコードを見つけ、usps_get_city_stateはZIPコードの都市と州を見つけます。州は2文字のコードです。米国の住所(領土や軍事住所を含む)のみが対象です。
価格:荷物はポンドで計量され、インチで測定されます。手紙、フラット、カードはオンスで計量されます。price_type COMMERCIALはオンラインで購入したラベルの価格、RETAILは郵便局のカウンター価格、CONTRACTはaccount_typeとaccount_numberが必要です。usps_search_domestic_pricesはrateOptionsを返し、totalBasePrice、totalPrice、および追加サービスを含みます。usps_list_domestic_pricesは、各製品のSKU、rateIndicator、およびprocessingCategoryを含むすべての適格製品をリストします。usps_search_letter_pricesはファーストクラスメールの手紙、フラット、はがきの価格を提供します。国外の場合:usps_search_international_prices(オプションで項目ごとの関税と税金を含む)、usps_list_international_prices、およびusps_search_international_letter_prices。郵送日は今日から最大7日先まで可能です。金額は米ドルです。USPS_GROUND_ADVANTAGEはファーストクラスパッケージサービスとリテールグラウンドに取って代わりました。
配達日:usps_get_delivery_estimatesは、特定の日に受け付けた郵便の予定配達日を提供し、受け付けの締切時間(cutOffTime、HHMMローカル)を示します。usps_get_service_standardsは、郵便クラスごとの標準的な日数を提供し、usps_get_international_service_standardは「推定配達日数は5-9営業日」といった文を返します。サービス基準は目標であり、保証ではありません。
追跡:usps_track_packageは1つの番号を追跡し、usps_track_packagesは最大35の番号を一度に追跡します。両方ともTracking 3.2を使用します。レガシーTracking 3.0 APIは2027年7月31日に廃止されます。応答にはstatusCategory、statusSummary、trackingEvents(eventTimestampはイベントのローカル時間、GMTTimestampはUTC)、deliveryDateExpectation、およびuniqueTrackingIDが含まれます。バッチは、いくつかの番号が失敗した場合にHTTP 207を返し、各失敗した番号には独自のerrorが含まれます。usps_register_tracking_notificationsは追跡メール用に最大3つのメールアドレスを登録し、usps_request_proof_of_deliveryは配達証明書をメールで送信します。両方とも追跡応答のuniqueTrackingIDが必要で、USPSからのメールを送信し、費用はかかりません。
ロケーション:usps_find_post_officesはZIPコード、都市と州、住所、または座標(半径はマイルで、デフォルトは20)で検索し、各サービスの営業時間をリストします。usps_find_dropoff_locationsは、目的地のZIPコードごとにParcel Select、USPS Connect、Package Servicesの目的地エントリ施設をリストします。usps_find_parcel_lockersはパーセルロッカーを見つけます。
ピックアップ:usps_check_pickup_eligibilityとusps_get_pickupは読み取り専用です。usps_schedule_pickupは無料のキャリアピックアップを予約し(月曜日から土曜日)、usps_cancel_pickupは1つをキャンセルします。両方ともオフになっています。ここでピックアップを変更することはできません:キャンセルして新しいものを予約してください。
ラベル(オフになっています):すべてのラベル呼び出しには支払い承認トークンが必要です。usps_create_payment_authorizationはあなたのCRID、メール業者ID、EPSアカウントを使用してpaymentAuthorizationTokenを返します。それをusps_create_label、usps_create_return_label、usps_create_international_label、usps_cancel_label、またはusps_cancel_international_labelに渡します。ラベルはJSON形式で返されます:labelMetadataには追跡番号と郵便料金が含まれ、labelImageはbase64形式(デフォルトは4x6 PDF)です。ラベルを作成すると、EPSアカウントから郵便料金が購入されます。キャンセルはCANCELEDとして返され、USPSが払い戻しリクエストを開いた場合はDISPUTEDとしてdisputeIdが返されます。usps_get_payment_accountはアカウントを読み取り、amountが指定されている場合は資金が十分かどうかを示します。usps_create_scan_formは多くのラベルを1つのPS Form 5630にまとめて、単一の受け入れスキャンで各パッケージを記録します。これらのツールはUSPSがラベルAPIを承認した後にのみオンにし、最初にテストホストで試してください。
エラー:失敗はerrorとして返され、code、message、およびリストerrors(title、detail、source.parameter)が含まれます。400は間違ったフィールドを示し、401は資格情報が間違っているかトークンが期限切れであることを示し、403はアプリがそのAPIを持っていないことを示します(デフォルト製品の外にあります)。404はUSPSが何も見つけられなかったことを示します(例:不明な追跡番号)。
制限:各アプリには時間あたりの呼び出しのクォータがあります。429は次の時間まで使用できないことを示します。USPSはEmail Usページを通じてリクエストに応じてクォータを増加させます。日付はYYYY-MM-DD形式です。
前提条件:USPS_CLIENT_ID、USPS_CLIENT_SECRET、USPS_API_HOST
コネクタをローカルにインストールする
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を開き、USPSを選択し、前提条件に記載された環境変数を貼り付けます。
利用可能なツール
| ツール | 機能 |
|---|---|
usps_validate_address | 1つの米国住所を検証し、標準化します。USPS標準形式(streetAddress、city、state、ZIPCode、ZIPPlus4)でaddressを返します… |
usps_get_city_state | 5桁のZIPコードの都市と州を検索します。city(大文字)、state(2文字)、ZIPCodeを返します。安価な呼び出しで、… |
usps_get_zip_code | 都市と州のストリートアドレスのZIPコードとZIP+4を見つけます。標準化されたストリート、city、stateを含むaddressを返します… |
usps_search_domestic_prices | 国内パッケージの価格を郵便クラスごとに計算し、追加サービスを含みます。適格製品ごとに1つのrateOptionsを返します… |
usps_list_domestic_prices | 国内パッケージが適格なすべての製品をリストし、基本価格と追加サービスなしで返します。rateOptionsを返します… |
usps_search_letter_prices | 米国内で送信されるファーストクラスメールの手紙、フラット(大封筒)、またははがきの価格を計算します。totalBasePriceとrates(SKU… |
usps_search_international_prices | 国際パッケージの価格を計算し、追加サービスを含め、リクエストに応じて項目ごとの関税と税金を含みます。適格製品ごとに1つのrateOptionsを返します… |
usps_list_international_prices | 国際パッケージが適格なすべての製品をリストし、基本価格と追加サービスなしで返します。rateOptionsを返します… |
usps_search_international_letter_prices | ファーストクラスメール国際手紙、フラット、またははがきの価格を計算します。totalBasePrice、rates(SKU、description、price、fees)を返します… |
usps_get_delivery_estimates | 特定の日に受け付けた郵便の配達日を推定します。郵便クラスごとに1つのエントリを持つリストを返し、serviceStandard(日数)を含みます… |
usps_get_service_standards | 2つのZIPコード間の郵便クラスごとの標準的な配達日数を取得します。mailClass、daysを含むリストを返します… |
usps_get_international_service_standard | 国への国際郵便クラスの期待される配達時間を取得します。countryCode、mailClassを返します… |
usps_search_shipping_options | 1つのパッケージを発送するすべての方法を1回の呼び出しで比較します:価格と配達の約束を一緒に、国内または国際。返します… |
usps_track_package | 1つのUSPSパッケージをTracking 3.2で追跡します。trackingNumber、uniqueTrackingID、mailClass、status、statusCategory(例:… |
usps_track_packages | 最大35のUSPSパッケージを1回の呼び出しでTracking 3.2で追跡します。各番号に対して1つの結果を返し、trackingNumber、uniqueTrackingID… |
usps_register_tracking_notifications | 1つのパッケージに関するUSPS追跡メール用に最大3つのメールアドレスを登録します:予想配達の更新、配達活動、またはすべての更新。必要です… |
usps_request_proof_of_delivery | 配達されたパッケージの配達証明書(または電子的な返送受領書)を最大3人の受取人にUSPSがメールで送信します。必要です… |
usps_find_post_offices | ZIPコード、住所、または座標の近くにある郵便局やその他の小売場所を見つけます。最も近いものから返します。locationsを返します… |
usps_find_dropoff_locations | 目的地のZIPコードに対してParcel Select、USPS Connect、Package Servicesの郵便をドロップオフできる目的地エントリ施設を見つけます… |
usps_find_parcel_lockers | ZIPコードまたは都市と州でUSPSパーセルロッカーを見つけます。facilityID、locationName、locationAddressを含むロッカーのリストを返します… |
usps_check_pickup_eligibility | USPSが住所で無料のキャリアピックアップを提供しているかどうかを確認します。住所が標準化された形式である場合、200で応答します… |
usps_get_pickup | 確認番号でスケジュールされたキャリアピックアップを取得します。confirmationNumber、pickupDate、およびcarrierPickupRequest(住所… |
usps_get_payment_account | エンタープライズ支払いアカウントまたは許可を確認します。アカウントの詳細を返し、amountが指定されている場合はsufficientFunds(trueまたはfalse)を返します… |
usps_create_payment_authorization | すべてのラベル呼び出しに必要な支払い承認トークンを取得します:あなたのビジネスをPAYERおよびLABEL_OWNERとして名前付けし、CRID、メール業者IDを使用します… |
usps_create_label | 郵便料金を購入し、エンタープライズ支払いアカウントから支払いを行い、国内配送ラベルを作成します。返します… |
usps_create_return_label | 顧客がパッケージを返送するための国内返送ラベルを作成します(to_addressはあなたの返品住所、from_addressは顧客の住所)。… |
usps_cancel_label | 未使用の国内ラベルをキャンセルするか、郵便料金の払い戻しを要求します。trackingNumber、status(CANCELED、または払い戻しリクエストがある場合はDISPUTED)を返します… |
usps_create_international_label | 郵便料金を購入し、国際ラベルを作成します。税関申告書を含む(ファーストクラスパッケージ国際サービス、プライオリティメール国際… |
usps_cancel_international_label | 未使用の国際ラベルをキャンセルするか、郵便料金の払い戻しを要求します。追跡番号、status(CANCELEDまたはDISPUTED)、および… |
usps_schedule_pickup | あなたの住所でパッケージのために無料のUSPSキャリアピックアップを予約します(月曜日から土曜日;当日分は午前2時中央時間まで)。返します… |
usps_cancel_pickup | 確認番号でスケジュールされたキャリアピックアップをキャンセルします。キャンセルされた場合は200を返します。インストールはオフになっており、キャンセルは… |
usps_create_scan_form | ラベルを1つのバーコードにリンクさせるSCANフォーム(PS Form 5630)を作成します。これにより、受け入れ時に単一のスキャンで各パッケージを記録します。返します… |
例のプロンプト
- "USPSパッケージ9400111899223197428490はどこですか?"
- "1600 Pennsylvania Ave NW, Washington DC 20500は有効な住所ですか?そのZIP+4は何ですか?"
- "明日、10001から94105に発送する3ポンドの箱のUSPS価格と配達日を比較してください。"
- "トロントへの2ポンドのパッケージのUSPSプライオリティメールの料金はどのくらいですか?"
- "ZIP 60614の近くで土曜日に開いている郵便局を見つけてください。"
次のステップ
このガイドは役に立ちましたか?