Target Shopping — Tar获取 Shopping

tar获取-com-shopper

Browse Tar获取.com from the 助手. Wraps a handful of Tar获取's public-facing JSON 端点s (the same ones tar获取.com itself loads) and one local URL 构建器 that pre-populates a guest cart in the user's browser.

DisclAImers & limitations

Unofficial. Not affiliated with, endorsed by, or sponsored by Tar获取 Corporation. "Tar获取" and the Tar获取 bullseye are trademarks of Tar获取 Brands, Inc.; they are used here only to describe the 服务 this 技能 talks to.

Public 网页 端点s, not a stable API. The 技能 calls Tar获取's public-facing 网页 API (the same JSON 端点s tar获取.com itself loads in your browser) and carts.tar获取.com. These are not a documented public API. Field shapes, auth keys, throttling, and even 端点 avAIlability can change without notice; expect breakage and pin the version you tested agAInst.

No warranty on prices, stock, or pickup ETAs. 结果s are point-in-time snapshots of what the API returned. Prices and avAIlability change constantly and may differ from what the user actually sees at 检查out. Always direct the user to buy_url for the source of truth before they commit to a purchase.

Personal / light use only. Single-shot lookups for a real shopping task, not bulk scrAPIng, competitive price 监控ing, or inventory mirroring. The in-script throttle (TAR获取_MIN_INTERVAL, default 1s) is the floor — do not lower it. See references/tos-and-etiquette.md.

The cart-link feature 创建s a real server-side guest cart. It mints a 24-hour anonymous bearer 令牌 agAInst gsp.tar获取.com and POSTs TCINs to carts.tar获取.com. Treat the 结果ing URL like a one-time 分享 link: it grants ~24h of cart-write 访问 to whoever holds it. No 记录in, payment 信息, or shipping 添加ress is ever transmitted.

No 检查out, payment, or auth. 检查out, returns, saved carts, Circle deals tied to an account, and order 历史 are out of scope and will stay out of scope. If you need any of those, open tar获取.com in a browser.

When to use "搜索 Tar获取 for X." "What's the price / rating / spec on Tar获取 product ?" "Is this in stock near ZIP ? When can I pick it up?" "Find Tar获取 stores near me." "Build me a Tar获取 cart link for these items." When NOT to use Anything requiring 记录in (saved carts, Circle deals tied to account, order 历史, returns, gift registry edits). This 技能 is read-only and intentionally un认证d. 检查out, payment, or shipping 添加resses. The 技能 builds a cart URL the user opens in their own browser; everything from there is on them. Bulk scrAPIng or price 监控ing. See references/tos-and-etiquette.md. 设置up (once)

The 技能 ships as a uv project under its own directory. From the 技能 root (~/.OpenClaw/workspace/技能s/tar获取-com-shopper/ at 运行time):

uv 同步

That's it — 运行time is stdlib-only; uv is just used for the venv and to 运行 scripts reproducibly.

Discover the user's store first

store_id shapes every product/price/fulfillment 响应. Ask the user for their ZIP code (or city) before calling product 端点s, then look up nearby stores:

uv 运行 python -m scripts.stores 55403 --limit 5

Pick a store_id from the 结果s and pass it as --store-id to 搜索, pdp, and summary. (Or 设置 TAR获取_DEFAULT_STORE_ID in the 环境 for the 会话.) If the user truly doesn't care about location, the default store (2281, San Jose Central) is fine for keyword 搜索 and PDP, but not for accurate "in stock today" answers.

Common tasks 搜索 uv 运行 python -m scripts.搜索 "wireless earbuds" --count 10 --store-id 1375 uv 运行 python -m scripts.搜索 --category 5xteg --count 10 uv 运行 python -m scripts.搜索 "chicken breast" --category 4tgi7 # keyword AND category

--raw returns the full API payload. Default trims to tcin, title, brand, price, rating, buy_url, image.

Fresh-grocery 搜索es: generic keyword 搜索 drowns fresh items in shelf-stable hits (e.g. "chicken breast" returns canned chicken first). Combine the keyword with a category N-ID to scope — see references/categories.md for the curated 列出 of common N-IDs (Fresh Chicken, Fresh Produce, Herbs & Spices, etc.).

Building a multi-item shopping 列出? The 技能 has no batched 搜索 端点 — plp_搜索_v2 accepts one 查询 at a time. Fire individual scripts.搜索 calls in parallel from the 代理 运行time; the in-script TAR获取_MIN_INTERVAL throttle (default 1s) 保护s the up流. For a 6-item 列出 expect ~6 seconds wall time. Do not lower TAR获取_MIN_INTERVAL below 0.5s — see references/tos-and-etiquette.md.

Product detAIl uv 运行 python -m scripts.pdp 89827259 --store-id 1375

Returns title, brand, price, bullets, images, promotions, variant TCINs.

Multi-product fulfillment summary

For a short列出 (e.g. comparing 3–5 candidates) use summary instead of calling pdp N times — one round trip:

uv 运行 python -m scripts.summary 89827259 94783927 --zip 55403 --store-id 1375

Note: summary does not return price. Combine with pdp if needed.

Per-store stock & pick