К основному содержанию
скилл CX Codex

rate-shopping — скилл для Claude Code: что делает и как установить

Скилл rate-shopping помогает запрашивать тарифы служб доставки через Shippo API, сравнивать сроки со стоимостью и подбирать варианты отправлений прямо в чате с агентом.

MIT 1 установок ★ 3 обновлён 2026-10-09

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add goshippo/ai --skill rate-shopping -a claude-code
Открыть на GitHub

Что делает rate-shopping

Скилл инструктирует агента собирать адреса и габариты посылки, чтобы отправлять запросы в Shippo API через вызовы CreateShipment или CreateLiveRate. Габариты и вес должны передаваться только строками (например, "10", а не числом), иначе запрос отработает некорректно. Ответ группируется в понятную таблицу с указанием перевозчика, уровня сервиса, цены и расчётных сроков доставки.

Логика поиска лучшего варианта вычисляется на стороне агента: модель сама сортирует массив тарифов, чтобы найти самую дешёвую, быструю или сбалансированную доставку. Если для одного перевозчика вернулось несколько дублей из разных подключённых аккаунтов, скилл оставляет наиболее выгодную ставку. Поддерживается конвертация через ListShipmentRatesByCurrencyCode и проверка обязательных таможенных деклараций для международных маршрутов.

Полученные тарифы действуют ровно 7 дней. Если покупка лейбла откладывается на больший срок, скилл потребует создать отправление заново для получения свежих цен.

Какие задачи решает

  • сравнить тарифы разных перевозчиков на одном маршруте
  • отфильтровать способы доставки по срокам прибытия посылки
  • рассчитать стоимость доставки для позиций корзины через CreateLiveRate
  • перевести котировки доставки в нужную валюту через Shippo API

Примеры запросов агенту

  • Сравни тарифы на доставку коробки весом "5" фунтов из Нью-Йорка в Остин и найди самый дешёвый вариант.
  • Найди экспресс-доставку со сроком до 2 дней для посылки размером "10"x"8"x"4" дюйма.
  • Рассчитай стоимость отправления через CreateLiveRate для корзины с двумя товарами.

Как установить rate-shopping

1Через Skills CLI (Vercel)

npx skills add goshippo/ai --skill rate-shopping -a claude-code

2Вручную: положить файлы

~/.claude/skills/rate-shopping/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/rate-shopping/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о rate-shopping

Как установить rate-shopping в Claude Code?

Выполните команду npx skills add goshippo/ai --skill rate-shopping -a claude-code в терминале.

Зачем нужен скилл rate-shopping?

Он даёт модели сценарии для валидации адресов, отправки запросов к Shippo API и фильтрации тарифов без ручной работы со структурой запросов.

Сколько времени действуют полученные тарифы Shippo?

Срок действия ставок составляет 7 дней. После этого срока агент должен создать новое отправление, чтобы обновить котировки перед покупкой лейбла.

Исходный текст

SKILL.md · MIT
---
name: rate-shopping
description: Compare multi-carrier shipping rates, find cheapest/fastest options, and get shipping recommendations via the Shippo API
---

# Rate Shopping and Comparison

## Get Rates for a Shipment

1. Collect: origin address, destination address, parcel (length, width, height, distance_unit, weight, mass_unit). All dimension and weight values must be **strings** (e.g., `"10"` not `10`).
2. Optionally validate both addresses with `ValidateAddress` (see Address Validation).
3. Call `CreateShipment` with `address_from`, `address_to` (as inline address objects using v1 field names -- `street1`, `city`, `state`, `zip`, `country` -- not object IDs), and `parcels`.
4. The response `rates` array contains available options. Present a table: carrier, service level, price, estimated days.
5. Note: the same carrier may return duplicate rates from multiple carrier accounts. Present the best rate per carrier/service combination.
6. Each rate carries an `object_id`. To buy a label, pass the chosen rate's `object_id` to the purchase flow (see Label Purchase); you do not re-send the address or parcel.

---

## Rate Expiration

Rates expire after 7 days. If a user tries to purchase a rate that was retrieved more than 7 days ago, create a new shipment to get fresh rates.

---

## Filter by Speed

Map user requests: "overnight" = estimated_days 1, "2-day" = estimated_days <= 2, "within N days" = estimated_days <= N. Filter the rates array accordingly. If nothing matches, show the fastest available option.

---

## International Rates

Some carriers may return international rates without a customs declaration, but others will not. If no rates are returned, try attaching a customs declaration to the shipment. Some carriers also require a phone number on the destination address for international rate retrieval. Inform the user that customs will be required at label purchase time regardless. See `shippo/references/customs-guide.md` for customs details.

---

## Checkout Rates (Line Items)

Call `CreateLiveRate` instead of `CreateShipment`. Accepts `address_from`, `address_to`, and `line_items` (each with title, quantity, total_price, currency, weight, weight_unit).

---

## Rates in a Specific Currency

Call `ListShipmentRatesByCurrencyCode` with the preferred ISO currency code (USD, EUR, GBP, CAD, etc.).

---

## Recommendation

Identify the cheapest (lowest `amount`), fastest (lowest `estimated_days`), and best-value options from the rates array. These are not API fields -- compute them by sorting the rates array yourself. State the trade-off: "Option A is $X cheaper but takes Y more days than Option B."

---

## Troubleshooting: No Rates

- Verify both addresses passed validation (most common cause).
- Confirm parcel dimensions are reasonable (not zero, not exceeding carrier limits).
- Shippo provides managed carrier accounts by default for major carriers. If no rates are returned, the issue is more likely address validation, unsupported route, or parcel dimensions -- not missing carrier accounts. You can verify with `ListCarrierAccounts` if needed.
- Rates expire after 7 days. If stale, create a new shipment to get fresh rates.

---

## Quick Reference

**Get rates:**
(optional) `ValidateAddress` (x2) -> `CreateShipment` (with inline addresses) -> read `rates` array

© goshippo · MIT · goshippo/ai

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
linkfox-shopee-store-logistics linkfox-ai Скилл linkfox-shopee-store-logistics для Claude Code, Codex и Cursor. Управляет доставкой в Shopee: отправляет посылки, создаёт накладные и отслеживает трек-номера. CX Codex +1 231установок mcp-skydropx codespar Подключает Skydropx к ИИ-агенту для работы с отправлениями, тарифами, этикетками и трекингом. Автоматизирует доставку в Мексике. CX Codex +1 ★ 279звёзд репо Multi-Carrier Shipping API — powered by Secureship secureship MCP-сервер Multi-Carrier Shipping API — powered by Secureship для Claude Code открывает живые схемы 150+ эндпоинтов Secureship для интеграции доставки. CX Codex +1 6 130установок mcp-andreani codespar Подключает к агенту API аргентинского курьера Andreani: создание отправлений, трекинг, тарифы и этикетки прямо из чата. CX Codex +1 ★ 279звёзд репо linkfox-temu-fulfillment-global linkfox-ai Скилл linkfox-temu-fulfillment-global для Claude Code управляет фулфилментом заказов Temu Global. Помогает купить этикетку, передать заказ на склад, оформить отправку и отследить посылку. CX Codex +1 324установок Shipi shipi MCP-сервер Shipi управляет отправкой посылок: сравнивает тарифы перевозчиков, создаёт наклейки, отслеживает грузы и вызывает курьера. CX Codex +1 162установок

Из того же набора6

shippo Скилл подключает Shippo к ИИ-агенту: расчёт тарифов, покупка этикеток, проверка адресов и отслеживание отправлений. CX Codex +1 1установок label-purchase Скилл label-purchase для создания и покупки почтовых этикеток через Shippo API. Поддерживает внутренние и международные отправления, таможенные декларации, возвратные этикетки и отмену покупок. CX Codex +1 1установок batch-shipping Скилл batch-shipping обрабатывает отправки из CSV через Shippo API: проверяет строки, покупает групповые этикетки и создаёт манифесты. Подходит для пакетной отправки заказов. CX Codex +1 1установок Shippo Удалённый MCP-сервер Shippo логистики: сравнивает тарифы 30+ перевозчиков, валидирует адреса и оформляет почтовые этикетки в диалоге с агентом. CX Codex +1 ★ 3звёзд репо shippo Плагин shippo для Claude Code помогает оформлять отправления, сравнивать тарифы перевозчиков и отслеживать посылки. Навыки также проверяют адреса и обрабатывают CSV с отправлениями. ★ 3звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой