linkfox-amazon-store-listings

Manage Amazon SP-API listings, restrictions, and product type definitions via LinkFox gateway.

17|3|Updated Jun 18, 2026
One-click install
npx skills add https://github.com/w9uk5ie8v/LinkFoxSkills --skill linkfox-amazon-store-listings-w9uk5ie8v
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linkfox-amazon-store-listings
Source: https://github.com/w9uk5ie8v/LinkFoxSkills/tree/main/linkfox-amazon-store-listings
Command: npx skills add https://github.com/w9uk5ie8v/LinkFoxSkills --skill linkfox-amazon-store-listings-w9uk5ie8v

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Managing Amazon store listings programmatically requires handling SP-API authentication, correct endpoint paths, query constraints, and product type schemas. This Skill wraps the LinkFox developer proxy so agents can get, search, patch, create, and delete listings, check ASIN listing restrictions, and retrieve product type JSON Schemas without hand-building every request. ## Core Features & Use Cases - Listings Items operations: Get a single listing by seller SKU, search listings with filters and pagination, partially update via JSON Patch, create or fully replace via PUT, and delete listings. - Listings Restrictions: Check whether an ASIN can be listed by a given seller in specific marketplaces, with condition and locale filters. - Product Type Definitions: Search available product types and fetch the JSON Schema for a product type to validate listing attributes before submission. - Use Case: A seller wants to update a listing title. The agent fetches the LUGGAGE product type schema, builds a compliant JSON Patch, and submits it through patchListingsItem with the correct marketplace ID. ## Quick Start Ask the agent to fetch the Amazon listing for a given seller ID, region, seller SKU, and marketplace ID using the LinkFox SP-API proxy.

Frequently Asked Questions about linkfox-amazon-store-listings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I update an Amazon listing title via SP-API?▼

Use patchListingsItem with the seller ID, region, seller SKU, marketplace ID, product type, and a patches array containing a JSON Patch operation such as replace on /attributes/item_name. The attribute value must conform to the product type's JSON Schema.

How to check if an ASIN can be listed on Amazon?▼

Call getListingsRestrictions with the ASIN, seller ID, and marketplace IDs. The response returns listing restrictions for that ASIN, and you can filter by conditionType and localize reasons with reasonLocale.

What is the difference between patchListingsItem and putListingsItem?▼

patchListingsItem applies partial JSON Patch updates to top-level listing attributes, while putListingsItem creates a listing or fully replaces it with a complete attributes object. PUT requires exactly one marketplace ID and a requirements value such as LISTING.

Does searchListingsItems support filtering by ASIN?▼

Yes, pass identifiers with identifiersType set to ASIN, up to 20 identifiers. However, identifiers are mutually exclusive with variationParentSku and packageHierarchySku, and pageSize is capped at 20.

Why does putListingsItem fail with multiple marketplace IDs?▼

Amazon restricts marketplaceIds to a single ID for putListingsItem, deleteListingsItem, and getDefinitionsProductType. The scripts reject requests with more than one marketplace ID for these operations.

What credentials are required to call Amazon SP-API through LinkFox?▼

You need a LINKFOXAGENT_API_KEY environment variable and an authorized seller account. The skill depends on linkfox-amazon-store-auth to obtain an access token via /spApi/storeTokens before proxying SP-API calls.