This skill provides tools for creating optimized Amazon product listings through AI-powered workflows. Use this skill when generating Amazon listings, fetching product details, running keyword research, or optimizing listing copy. Requires Aria MCP server URL and API key.
Create optimized Amazon product listings through a 5-step AI-powered workflow.
{
"mcpServers": {
"aria": {
"type": "sse",
"url": "https://mcp-brandtools-production.up.railway.app/sse",
"headers": {
"Authorization": "Bearer YOUR_MCP_API_KEY"
}
}
}
}
aria_listing_get_product_detailsFetch detailed product information from Amazon using Keepa API.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| asin | string | Yes | - |
| Amazon ASIN (10 characters) |
| country | string | No | "US" | Marketplace: US, UK, DE, FR, JP, CA, IT, ES, IN, MX, BR, AU, NL |
| response_format | string | No | "json" | Output: "json" or "markdown" |
Returns: Title, brand, description, bullet points, price, rating, review count, sales rank, category, images.
aria_listing_get_product_details(asin="B0CJTL53NK", country="US")
aria_listing_createStart the complete listing generation workflow (3-8 minutes).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| asin | string | No* | - | Amazon ASIN (provide asin+country OR listing_id) |
| country | string | No | "US" | Amazon marketplace |
| listing_id | string | No* | - | Existing listing UUID |
| threshold | integer | No | 70 | Substitute score threshold (0-100) |
| test_mode | boolean | No | false | Faster processing with limited data |
| response_format | string | No | "json" | Output format |
Workflow Steps:
Returns: task_id and listing_id for status monitoring.
aria_listing_create(asin="B0CJTL53NK", country="US", threshold=70)
aria_listing_get_statusCheck workflow progress. Poll every 5-10 seconds until SUCCESS or FAILED.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| task_id | string | Yes | - | Task ID from aria_listing_create |
| response_format | string | No | "json" | Output format |
Returns: Status (PENDING, IN_PROGRESS, SUCCESS, FAILED), progress %, current step, completed steps.
aria_listing_getRetrieve listing with generated content.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| listing_id | string | Yes | - | Listing UUID |
| include_keywords | boolean | No | false | Include keyword data |
| include_generated | boolean | No | true | Include generated copy |
| include_competitors | boolean | No | false | Include competitors |
| response_format | string | No | "json" | Output format |
aria_listing_list_workflowsList all workflows with optional filtering.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| status | string | No | - | Filter: pending, in_progress, completed, failed |
| limit | integer | No | 50 | Max results (1-1000) |
| offset | integer | No | 0 | Pagination offset |
| response_format | string | No | "json" | Output format |
aria_listing_keyword_researchStart keyword research using Jungle Scout (1-3 minutes).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| listing_id | string | Yes | - | Listing UUID |
| test_mode | boolean | No | false | Limit results |
| response_format | string | No | "json" | Output format |
aria_listing_finalize_keywordsRun two-stage AI keyword optimization (2-4 minutes).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| listing_id | string | Yes | - | Listing UUID |
| response_format | string | No | "json" | Output format |
Process:
aria_listing_generateGenerate optimized listing copy (1-2 minutes).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| listing_id | string | Yes | - | Listing UUID |
| response_format | string | No | "json" | Output format |
Generates:
aria_listing_healthCheck API health status.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| response_format | string | No | "json" | Output format |
# 1. Start the workflow
aria_listing_create(asin="B0CJTL53NK", country="US")
# Returns: task_id="abc123", listing_id="xyz789"
# 2. Poll status every 10 seconds
aria_listing_get_status(task_id="abc123")
# Wait for status="SUCCESS"
# 3. Get the generated listing
aria_listing_get(listing_id="xyz789", include_generated=true)