摘要
Ukrposhta (Укрпошта) API 适用于乌克兰的商业客户:货物跟踪、发货和 PDF 标签、国内价格估算、路线检查、客户和地址,以及带有邮局和营业时间的地址分类器。创建和删除发货功能已关闭。合同持有人和对方令牌。
引导式设置
2 分钟将 Ukrposhta 连接到 Claude、ChatGPT 或 Copilot
开始 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 为英文事件名称。
发货: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 列表形式返回,字段名称为大写;id 为字符串。
单位和注意事项:重量以克为单位,尺寸以厘米为单位,货币以 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 | 通过条形码获取一个发货的完整状态历史:按事件步骤、日期、邮局索引和名称、事件代码和事件名称(例如… |
ukrposhta_get_last_status | 通过条形码获取一个发货的最新状态:日期、邮局索引和名称、事件代码、事件名称和事件原因。只读 |
ukrposhta_get_last_statuses | 一次获取最多 50 个发货的最新状态,以及 Ukrposhta 不知道的条形码:按条形码日期、邮局、事件代码和… |
ukrposhta_get_shipment_route | 通过条形码获取发货的起始和目的地(国家和地方)。只读 |
ukrposhta_get_shipment | 通过 uuid 读取你账户中的一个发货:条形码、类型、发件人和收件人客户及地址、交付类型、包裹(重量… |
ukrposhta_get_shipment_by_barcode | 通过条形码读取你账户中的一个发货(与 ukrposhta_get_shipment 相同的字段)。只读 |
ukrposhta_list_sender_shipments | 列出为一个发件人客户创建的发货:uuid、条形码、收件人、交付类型、包裹、价格和生命周期状态。只读 |
ukrposhta_get_shipment_lifecycle | 从 eCom 侧获取一个发货的当前状态:shipmentUuid、shipmentBarcode、状态(CREATED、REGISTERED、DELIVERING、IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | 列出一个客户的发货组(103a 表格的注册):uuid、名称、类型、创建日期、关闭标志和发货数量… |
ukrposhta_list_group_shipments | 列出一个发货组中的发货:uuid、条形码、收件人、包裹、价格和生命周期状态。只读 |
ukrposhta_get_label | 下载你创建的发货的地址标签(贴纸),以 PDF 文件形式提供:默认 100 x 100 mm,或在 A4 或 A5 纸上。打印… |
ukrposhta_calculate_domestic_price | 在创建发货之前估算乌克兰境内发货的价格:交付价格以 UAH 计,原始交付价格,邮费交付价格… |
ukrposhta_check_route | 检查 Ukrposhta 是否在两个邮政编码之间提供服务:代码(可用时为 SUCCESS)、描述和 mrtps(移动邮局的… |
ukrposhta_get_client | 读取你账户中的一个客户(发件人或收件人):uuid、类型(个人、私人企业、公司)、名称、名、姓… |
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(名称)、地址、电话、类型、纬度、经度、邮政终端… |
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、乌克兰语和英语名称、地区。只读 |
ukrposhta_search_cities | 通过名称查找地方,可以选择在某个地区和区内:CITY_ID、乌克兰语和英语名称、类型(城市、村庄)、区、地区和… |
ukrposhta_search_streets | 通过名称查找地方的街道:STREET_ID、乌克兰语和英语名称、街道类型。只读 |
ukrposhta_get_house_postcode | 街道上房屋的邮政编码:门牌号和邮政编码。只读 |
示例提示
- "Ukrposhta 包裹 0503112345678 在哪里?"
- "显示昨天发货的这 10 个条形码的最新状态。"
- "从基辅 01001 到利沃夫 79000 的 2 公斤包裹多少钱?"
- "邮政编码 65000 附近有哪些邮局,周六的营业时间是什么时候?"
- "下载发货 0503112345678 的标签。"
下一步
这份指南对你有帮助吗?