Skip to content

feat(asin): add Asin integration - #9833

Open
josselinlbe wants to merge 2 commits into
simstudioai:stagingfrom
asindotdev:feat/asin-integration
Open

josselinlbe wants to merge 2 commits into
simstudioai:stagingfrom
asindotdev:feat/asin-integration

Conversation

@josselinlbe

Copy link
Copy Markdown

Summary

Adds a Asin integration: tools, block, icon and generated docs page. I work on Asin, so this PR comes from the Asin team.

Search an Amazon store, read every seller's offer for an ASIN with Amazon's own price and the lowest new and used offers, and get a product's price history with its lowest, highest and average price, across 11 Amazon marketplaces.

Operations:

  • Search Products (asin_search_products): Search an Amazon store and get up to 60 results, sponsored ones included, with ASIN, title, price, rating and review count.
  • Read Offers (asin_read_offers): Read every offer for an ASIN from Amazon now (uses a credit): seller, price, Prime and FBA, delivery, with Amazon's own price and the lowest new and used offers.
  • Get Last Known Offers (asin_get_offers): Get the offers last read for an ASIN, cheapest first, with Amazon's own price and the lowest new and used offers, without reading Amazon again.
  • Get Price History (asin_get_price_history): Get every price read for an ASIN over a period, oldest first, with its lowest, highest and average price.

Credentials are an Asin API key on the block (AuthMode.ApiKey), sent as a bearer token. Every tool is an external ToolConfig.request against the Asin API.

Product update (if relevant)

E-commerce and brand teams can watch Amazon prices and sellers, and agents can judge whether a price is a real deal. The block appears in the integrations catalog with 7 templates and grounded skills; the docs page is apps/docs/content/docs/integrations/asin.mdx.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation
  • Other: ___________

Testing

  • Outputs follow the documented OpenAPI response schemas, and every tool was run against the live Asin API through its request and transformResponse to confirm the mapped outputs; fields that the API documents as nullable are optional outputs.
  • Local gate on this branch: bun run lint, bun run type-check, bun run check:audits (all 62 audits), bun run apps/sim/scripts/check-block-registry.ts origin/staging, bun run apps/sim/scripts/check-canvas-sentences.ts --block=asin, and the existing blocks and tools/request-transport Vitest suites all pass.
  • Regenerated artifacts are committed: tool metadata, docs, block successors and the docs manifest.
  • No new unit tests, following the repo's testing guidance; the live run above is the end-to-end check.

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Screenshots/Videos

Add an Asin block for Amazon price data across 11 Amazon stores:
- Search Amazon products with ASIN, price, rating and review count
- Read every seller's offer for an ASIN from Amazon now, or get the last
  known offers without reading Amazon again
- Get a product's price history with its lowest, highest and average price

Outputs follow the documented OpenAPI schemas and were checked against live
responses. Credentials are an Asin API key sent as a bearer token.
@vercel

vercel Bot commented Nov 10, 2026

Copy link
Copy Markdown

Someone is attempting to deploy a commit to the Sim Team on Vercel.

A member of the Team first needs to authorize it.

@greptile-apps

greptile-apps Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

RetriggerView in GreptileConfidence Score: 4/5

[Medium impact] The PR adds a new Amazon data workflow for users who configure Asin.

The PR appears safe to merge, with a non-blocking correction to the advertised Prime information.

Findings

  1. P2 Prime information is missing ▶

Summary

Adds the Asin integration for Amazon product searches, live and saved offers, and price history.

  • Asin searches an Amazon store and returns matching products.
  • Asin reads current Amazon offers for a product.
  • Asin retrieves the last saved offers without rereading Amazon.
  • Asin returns a product's price history and summary.
  • The Asin block brings four Amazon product actions into Sim.

Reviews (1) · Last reviewed commit: "feat(asin): add Asin integration" · Reviewed by Greptile

Comment thread apps/sim/tools/asin/read_offers.ts Outdated
id: 'asin_read_offers',
name: 'Asin Read Offers',
description:
"Read every offer for an ASIN from Amazon now (uses a credit): seller, price, Prime and FBA, delivery, with Amazon's own price and the lowest new and used offers.",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Prime information is missing

asin_read_offers promises Prime information, but mapAsinOffer never returns it and the offer schema has no Prime field. Users and agents cannot check Prime eligibility from this output. Remove the Prime claim from the description and generated docs, or expose the field if the API provides it.

- Describe Read Offers without Prime, which the API does not return
- Keep response mappers with a single caller in that tool's file
- Document the AsinIcon export
- Read the operation from the mapper context so agent tools coerce Days too

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant