rate-shopping — скилл для Claude Code: что делает и как установить
Скилл rate-shopping помогает запрашивать тарифы служб доставки через Shippo API, сравнивать сроки со стоимостью и подбирать варианты отправлений прямо в чате с агентом.
MIT 1 установок ★ 3 обновлён 2026-10-09
npx skills add goshippo/ai --skill rate-shopping -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/rate-shopping/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rate-shopping/
1Через Skills CLI (Vercel)
npx skills add goshippo/ai --skill rate-shopping -a codex2Вручную: положить файлы
.agents/skills/rate-shopping/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add goshippo/ai --skill rate-shopping -a cursor2Вручную: положить файлы
.cursor/skills/rate-shopping/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install goshippo/ai skills/rate-shopping2Вручную: положить файлы
.github/skills/rate-shopping/SKILL.md1Через Skills CLI (Vercel)
npx skills add goshippo/ai --skill rate-shopping -a gemini-cli2Командой платформы
gemini skills install https://github.com/goshippo/ai --path skills/rate-shoppingВручную: положить файлы
.devin/skills/rate-shopping/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add goshippo/ai --skill rate-shopping -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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