概要
ウクライナのビジネス顧客向けのUkrposhta (Укрпошта) API: 出荷追跡、出荷およびPDFラベル、国内価格見積もり、ルートチェック、クライアントと住所、郵便局と営業時間を含む住所分類器。出荷の作成と削除はオフになっています。契約者トークンと相手方トークン。
ガイド付きセットアップ
Ukrposhta を Claude、ChatGPT、Copilot に 2 分で接続
AnythingMCP Cloud の無料トライアルを始め、ガイド付きセットアップで Ukrposhta を接続して、MCP URL を AI アシスタントに追加します。コードもサーバーの運用も不要です。
クレジットカード不要 · 7日間の試用 · セルフホストの選択肢あり
こう聞いてみよう
Ukrposhta のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要?cloud.anythingmcp.comに直接アクセスしてください。 サインインし、Connectors → Ukrposhtaをクリックして、認証情報を貼り付け、MCP APIキーを生成すれば完了です。Dockerも
git cloneもローカルサーバーも不要です。
Ukrposhta
ウクライナのビジネス顧客向けのUkrposhta (Укрпошта) API: 出荷追跡、出荷およびPDFラベル、国内価格見積もり、ルートチェック、クライアントと住所、郵便局と営業時間を含む住所分類器。出荷の作成と削除はオフになっています。契約者トークンと相手方トークン。
セットアップ
- UkrposhtaとAPI契約を結びます(ビジネス顧客サービス、[email protected])。契約書には、プロダクションキーが記載された付属書が送付されます。
- PRODUCTION BEARER eComを
UKRPOSHTA_ECOM_BEARERに、PRODUCTION BEARER StatusTrackingをUKRPOSHTA_TRACKING_BEARERに、PROD_COUNTERPARTY TOKENをUKRPOSHTA_COUNTERPARTY_TOKENにコピーします。
サンドボックスキー(SANDBOX ...)はここでは機能しません。このコネクタはプロダクションホストを呼び出します。eComベアラーは住所分類器とラベルサービスも開きます。追跡には独自のベアラーがあり、相手方トークンはクライアントと出荷に関する呼び出しであなたのアカウントを識別します。
開始する場所: ukrposhta_track_shipmentまたはukrposhta_get_last_statusをバーコードとともに使用します。あなたのアカウントの出荷については、ukrposhta_get_shipment_by_barcodeまたはukrposhta_list_sender_shipmentsを送信者のクライアントUUIDとともに使用します。
追跡: ukrposhta_track_shipment(すべてのイベント)、ukrposhta_get_last_status、ukrposhta_get_last_statuses(最大50のバーコード)およびukrposhta_get_shipment_route。langには英語のイベント名のためにenを渡します。
出荷: ukrposhta_get_shipment、ukrposhta_get_shipment_by_barcode、ukrposhta_list_sender_shipments、ukrposhta_get_shipment_lifecycle、ukrposhta_list_shipment_groups、ukrposhta_list_group_shipments、およびukrposhta_get_label(PDF)。出荷前に、ukrposhta_check_routeおよびukrposhta_calculate_domestic_price(UAH、契約割引なし)を使用します。
出荷の作成はUkrposhtaの順序に従います: ukrposhta_create_addressで送信者と受信者の住所を作成し、各々に対してukrposhta_create_clientを使用します(または再利用します: ukrposhta_get_client、ukrposhta_find_clients_by_phone、ukrposhta_get_address)、次にukrposhta_create_shipment、最後にラベルを作成します。ukrposhta_create_shipmentとukrposhta_delete_shipmentはオフになっています: 作成された出荷は引き渡し時に料金が発生し、削除されたものは復元できません。住所とクライアントは無料です。
住所分類器: ukrposhta_search_regions、ukrposhta_search_districts、ukrposhta_search_cities、ukrposhta_search_streets、ukrposhta_get_house_postcode、ukrposhta_get_city_by_postcode、および郵便局のためにukrposhta_find_post_offices_by_postcode、ukrposhta_find_post_offices_near、ukrposhta_get_post_office_hoursを使用します。回答はEntries.Entryリストとして返され、大文字のフィールド名が含まれます; idsは文字列です。
単位と落とし穴: 重量はグラム、サイズはセンチメートル、金額はUAH。配達タイプ: W2W(郵便局から郵便局へ)、W2D(玄関まで)、D2W(玄関から郵便局へ)およびD2D(玄関から玄関へ)。RESTRICTED_ACCESSとマークされた郵便番号は、送信者または返送先住所としてのみ使用できます。ステータス: CREATED(まだ引き渡されていない)、REGISTERED、DELIVERING、IN_DEPARTMENT(オフィスで待機中)、DELIVERED、RETURNING、RETURNED、CANCELLED、DELETED。時間はキエフの現地時間です。
前提条件: UKRPOSHTA_ECOM_BEARER、UKRPOSHTA_TRACKING_BEARER、UKRPOSHTA_COUNTERPARTY_TOKEN
コネクタをローカルにインストールする
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を開き、Ukrposhtaを選択し、前提条件に記載された環境変数を貼り付けます。
利用可能なツール
| ツール | 何をするか |
|---|---|
ukrposhta_track_shipment | バーコードによる1つの出荷の完全なステータス履歴: イベントステップごと、日付、郵便局のインデックスと名前、イベントコードおよびeventName(例… |
ukrposhta_get_last_status | バーコードによる1つの出荷の最新のステータス: 日付、郵便局のインデックスと名前、イベントコード、eventNameおよびeventReason。読み取り専用 |
ukrposhta_get_last_statuses | 最大50の出荷の最新のステータスを一度に取得し、Ukrposhtaが知らないバーコードも含む: バーコードごとに日付、郵便局、イベントコードおよび… |
ukrposhta_get_shipment_route | バーコードによる出荷の出発地と到着地(国と地域)。読み取り専用 |
ukrposhta_get_shipment | UUIDによるあなたのアカウントの1つの出荷を読み取ります: バーコード、タイプ、送信者および受信者のクライアントと住所、deliveryType、パーセル(重量… |
ukrposhta_get_shipment_by_barcode | バーコードによるあなたのアカウントの1つの出荷を読み取ります(ukrposhta_get_shipmentと同じフィールド)。読み取り専用 |
ukrposhta_list_sender_shipments | 1つの送信者クライアントのために作成された出荷のリスト: uuid、バーコード、受信者、deliveryType、パーセル、価格およびライフサイクルステータス。読み取り専用 |
ukrposhta_get_shipment_lifecycle | eCom側からの1つの出荷の現在のステータス: shipmentUuid、shipmentBarcode、ステータス(CREATED、REGISTERED、DELIVERING、IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | 1つのクライアントの出荷グループ(フォーム103aの登録)のリスト: uuid、名前、タイプ、作成日、クローズフラグおよび出荷数。… |
ukrposhta_list_group_shipments | 1つの出荷グループ内の出荷のリスト: uuid、バーコード、受信者、パーセル、価格およびライフサイクルステータス。読み取り専用 |
ukrposhta_get_label | あなたが作成した出荷の住所ラベル(ステッカー)をPDFファイルとしてダウンロードします: デフォルトで100 x 100 mm、またはA4またはA5の用紙に印刷します。… |
ukrposhta_calculate_domestic_price | 出荷を作成する前にウクライナ国内の出荷の価格を見積もります: deliveryPriceはUAH、rawDeliveryPrice、postPayDeliveryPrice… |
ukrposhta_check_route | Ukrposhtaが2つの郵便番号間で配達できるか確認します: コード(利用可能な場合はSUCCESS)、説明およびmrtps(モバイル郵便局の場所… |
ukrposhta_get_client | あなたのアカウントの1つのクライアント(送信者または受信者)を読み取ります: uuid、タイプ(INDIVIDUAL、PRIVATE_ENTREPRENEUR、COMPANY)、名前、firstName、lastName… |
ukrposhta_find_clients_by_phone | 電話番号であなたのアカウントのクライアントを見つけます: uuid、名前、タイプ、住所。読み取り専用 |
ukrposhta_get_address | ukrposhta_create_addressで作成された住所を読み取ります: id、郵便番号、地域、地区、都市、通り、家番号、アパート番号、国… |
ukrposhta_create_address | クライアントまたは出荷のために使用する住所を作成します。郵便番号のみが必要です; 玄関配達のために通りと家を追加します。無料; 回答は… |
ukrposhta_create_client | ukrposhta_create_addressの住所に基づいてクライアント(送信者または受信者)を作成します。個人および個人事業主はfirst_nameが必要です… |
ukrposhta_create_shipment | 送信者クライアントから受信者クライアントへの国内出荷を作成します。バーコードと価格が付与され、オフィスで引き渡されると料金が発生します。 |
ukrposhta_delete_shipment | ステータスがCREATED(まだ引き渡されていない)である出荷を削除します。元に戻すことはできません。オフになっています |
ukrposhta_find_post_offices_by_postcode | 郵便番号を担当する郵便局: ID、PO_SHORTおよびPO_LONG(名前)、ADDRESS、PHONE、TYPE_LONG、LATITUDE、LONGITUDE、POSTTERMINAL… |
ukrposhta_find_post_offices_near | ポイントの近くの郵便局、最も近いものから: ID、名前、住所、郵便番号、距離、座標およびタイプ。読み取り専用 |
ukrposhta_get_post_office_hours | 郵便番号による郵便局の営業時間: 曜日ごとに開店時間と閉店時間および休憩。読み取り専用 |
ukrposhta_get_city_by_postcode | 郵便番号の地域、地区および地域、そのIDを含む。読み取り専用 |
ukrposhta_search_regions | 名前の一部で地域(州)を見つけます、ウクライナ語または英語で: REGION_ID、REGION_UA、REGION_EN、KOATUUおよびKATOTTGコード。両方を… |
ukrposhta_search_districts | 名前で地域の地区を見つけます: DISTRICT_ID、UAおよびENの名前、地域。読み取り専用 |
ukrposhta_search_cities | 名前で地域や地区内でローカリティを見つけます: CITY_ID、UAおよびENの名前、タイプ(都市、村)、地区、地域および… |
ukrposhta_search_streets | 名前でローカリティの通りを見つけます: STREET_ID、UAおよびENの名前、通りのタイプ。読み取り専用 |
ukrposhta_get_house_postcode | 通りの家の郵便番号: 家番号とPOSTCODE。読み取り専用 |
例のプロンプト
- "Ukrposhtaの小包0503112345678はどこですか?"
- "昨日の発送からのこれら10のバーコードの最新のステータスを表示してください。"
- "キエフ01001からリヴィウ79000までの2kgの小包はいくらですか?"
- "郵便番号65000の近くにある郵便局はどこで、土曜日の営業時間はいつですか?"
- "出荷0503112345678のラベルをダウンロードしてください。"
次のステップ
このガイドは役に立ちましたか?