nexscope-ai/nexscope-ecommerce-skills / ecommerce-amazon-store-catalog
ecommerce.amazon-store-catalog
VerifiedSearch the Amazon catalog and retrieve item information by ASIN.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.5 KB |
| manifest.json | config | 392 B |
| references/api.json | config | 7.4 KB |
| references/api.md | markdown | 5.7 KB |
| references/testing.md | markdown | 1.1 KB |
| scripts/amazon_sp_api.py | script | 5.3 KB |
references/api.md
View on GitHub# Amazon Store Catalog API reference
Migration reference: `linkfox-amazon-store-catalog` from the reviewed supplier master.
These operations use Nexscope public Data API endpoints below. The legacy `/api/v1/tools/research/` routes do not implement this contract.
Use `NEXSCOPE_API_KEY` and optionally `NEXSCOPE_PROXY_BASE`. All request and response JSON in `api.json` is illustrative.
| Operation | Nexscope POST path | Scope |
| --- | --- | --- |
| `getcatalogitem-2020-12-01` | `/spapi/getCatalogItemV20201201` | Authorized connection where required |
| `getcatalogitem-2022-04-01` | `/spapi/getCatalogItemV20220401` | Authorized connection where required |
| `listcatalogcategories` | `/spapi/listCatalogCategories` | Authorized connection where required |
| `searchcatalogitems-2020-12-01` | `/spapi/searchCatalogItemsV20201201` | Authorized connection where required |
| `searchcatalogitems-2022-04-01` | `/spapi/searchCatalogItemsV20220401` | Authorized connection where required |
## Parameters and examples
See the field definitions and JSON examples below, or use the machine-readable `api.json`.
### `amazon-sp-api-catalog-getcatalogitem-2020-12-01`
MCP tool: `nexscope_amazon_sp_api_catalog_getcatalogitem_2020_12_01`.
Amazon operation: `GET /catalog/2020-12-01/items/{asin}`.
- `connectionId` (integer, required). Owned Amazon Seller connection ID.
- `pathParams` (object, required). Required path values: asin.
- `queryString` (string, optional). Operation query string, percent encoded, without the leading ?.
Illustrative request
```json
{
"connectionId": 123,
"pathParams": {
"asin": "B000EXAMPL"
},
"queryString": "marketplaceIds=ATVPDKIKX0DER"
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"sellerId": "EXAMPLE_SELLER",
"requestId": "example-request-id",
"source": "BACKEND_AMAZON_SP_API",
"response": {
"httpStatus": 200,
"payload": {
"asin": "B000EXAMPL"
}
}
}
}
```
### `amazon-sp-api-catalog-getcatalogitem-2022-04-01`
MCP tool: `nexscope_amazon_sp_api_catalog_getcatalogitem_2022_04_01`.
Amazon operation: `GET /catalog/2022-04-01/items/{asin}`.
- `connectionId` (integer, required). Owned Amazon Seller connection ID.
- `pathParams` (object, required). Required path values: asin.
- `queryString` (string, optional). Operation query string, percent encoded, without the leading ?.
Illustrative request
```json
{
"connectionId": 123,
"pathParams": {
"asin": "B000EXAMPL"
},
"queryString": "marketplaceIds=ATVPDKIKX0DER"
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"sellerId": "EXAMPLE_SELLER",
"requestId": "example-request-id",
"source": "BACKEND_AMAZON_SP_API",
"response": {
"httpStatus": 200,
"payload": {
"asin": "B000EXAMPL"
}
}
}
}
```
### `amazon-sp-api-catalog-listcatalogcategories`
MCP tool: `nexscope_amazon_sp_api_catalog_listcatalogcategories`.
Amazon operation: `GET /catalog/v0/categories`.
- `connectionId` (integer, required). Owned Amazon Seller connection ID.
- `queryString` (string, optional). Operation query string, percent encoded, without the leading ?.
Illustrative request
```json
{
"connectionId": 123,
"queryString": "MarketplaceId=ATVPDKIKX0DER&ASIN=B000EXAMPL"
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"sellerId": "EXAMPLE_SELLER",
"requestId": "example-request-id",
"source": "BACKEND_AMAZON_SP_API",
"response": {
"httpStatus": 200,
"payload": {
"payload": [
{}
]
}
}
}
}
```
### `amazon-sp-api-catalog-searchcatalogitems-2020-12-01`
MCP tool: `nexscope_amazon_sp_api_catalog_searchcatalogitems_2020_12_01`.
Amazon operation: `GET /catalog/2020-12-01/items`.
- `connectionId` (integer, required). Owned Amazon Seller connection ID.
- `queryString` (string, optional). Operation query string, percent encoded, without the leading ?.
Illustrative request
```json
{
"connectionId": 123,
"queryString": "keywords=travel%20mug&marketplaceIds=ATVPDKIKX0DER"
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"sellerId": "EXAMPLE_SELLER",
"requestId": "example-request-id",
"source": "BACKEND_AMAZON_SP_API",
"response": {
"httpStatus": 200,
"payload": {
"numberOfResults": 1,
"pagination": {
"nextToken": "EXAMPLE",
"previousToken": "EXAMPLE"
},
"refinements": {
"brands": [
{
"numberOfResults": 1,
"brandName": "EXAMPLE"
}
],
"classifications": [
{
"numberOfResults": 1,
"displayName": "EXAMPLE",
"classificationId": "EXAMPLE"
}
]
},
"items": [
{
"asin": "B000EXAMPL"
}
]
}
}
}
}
```
### `amazon-sp-api-catalog-searchcatalogitems-2022-04-01`
MCP tool: `nexscope_amazon_sp_api_catalog_searchcatalogitems_2022_04_01`.
Amazon operation: `GET /catalog/2022-04-01/items`.
- `connectionId` (integer, required). Owned Amazon Seller connection ID.
- `queryString` (string, optional). Operation query string, percent encoded, without the leading ?.
Illustrative request
```json
{
"connectionId": 123,
"queryString": "marketplaceIds=ATVPDKIKX0DER&keywords=travel%20mug"
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"sellerId": "EXAMPLE_SELLER",
"requestId": "example-request-id",
"source": "BACKEND_AMAZON_SP_API",
"response": {
"httpStatus": 200,
"payload": {
"numberOfResults": 1,
"items": [
{
"asin": "B000EXAMPL"
}
]
}
}
}
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |