Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-amazon-search-by-image

ecommerce.amazon-search-by-image

Verified

Perform image-based visual product search on Amazon across 8 marketplaces. Use an image URL to find visually similar products, with optional Nexscope enrichment for sales data. Triggered when users mention Amazon image search, Amazon visual search, find similar products on Amazon, reverse image lookup Amazon, Amazon search by photo, or competitor image search. Even if the user does not explicitly mention "image search," this skill should be triggered whenever a user provides an image URL and wants to find visually matching or similar products on Amazon.

FileKindSize
SKILL.mdskill md8.2 KB
manifest.jsonconfig396 B
references/api.mdmarkdown10.8 KB
scripts/amazon_search_by_image.pyscript6.1 KB
scripts/upload_image.pyscript9.6 KB
---
name: ecommerce.amazon-search-by-image
description: Perform image-based visual product search on Amazon across 8 marketplaces. Use an image URL to find visually similar products, with optional Nexscope enrichment for sales data. Triggered when users mention Amazon image search, Amazon visual search, find similar products on Amazon, reverse image lookup Amazon, Amazon search by photo, or competitor image search. Even if the user does not explicitly mention "image search," this skill should be triggered whenever a user provides an image URL and wants to find visually matching or similar products on Amazon.
---

# Amazon Image-Based Search

This skill guides you on how to perform visual product searches on Amazon using an image URL, helping Amazon sellers and researchers find visually similar products across multiple marketplaces.

## Core Concepts

Amazon Image-Based Search (visual search) allows you to submit a product image URL and retrieve Amazon listings that are visually similar. This is invaluable for competitive analysis, sourcing alternatives, identifying counterfeits, and discovering market opportunities based on product appearance.

The tool searches across **8 Amazon marketplaces** and returns rich product data including ASIN, title, image, price, rating, review count, brand, and optionally Nexscope-enriched data (sales rank, monthly sales, FBA fees, dimensions, etc.).

## Supported Marketplaces

| Marketplace | Domain | Default Zip Code |
|-------------|--------|-------------------|
| United States | amazon.com | 10001 |
| United Kingdom | amazon.co.uk | EC1A 1BB |
| Germany | amazon.de | 10115 |
| France | amazon.fr | 75001 |
| Italy | amazon.it | 00100 |
| Spain | amazon.es | 28001 |
| Japan | amazon.co.jp | 100-0001 |
| India | amazon.in | 110034 |

Default marketplace is **amazon.com** (US). Use amazon.com when the user does not specify a marketplace.

## Parameter Guide

| Parameter | Required | Description |
|-----------|----------|-------------|
| imageUrl | Yes | A valid, publicly accessible image URL to search with |
| amazonDomain | Yes | Amazon marketplace domain (e.g., `amazon.com`, `amazon.de`). Defaults to `amazon.com` |
| sort | No | Sort order for results. Supported values: `default`, `price-asc-rank`, `price-desc-rank`, `rating-asc-rank`, `rating-desc-rank`, `ratings-asc-rank`, `ratings-desc-rank` |
| deliveryZip | No | Delivery address zip code within the marketplace country. Uses the marketplace default if not specified |
| countryOrAreaCode | No | Country/region code for cross-border delivery (e.g., `CN`, `JP`, `KR`). Cannot be used together with `deliveryZip`. Note: India marketplace does not support cross-border delivery |
| aggregateByKeepaData | No | Whether to enrich results with Nexscope data (sales rank, monthly sales, FBA fees, dimensions, etc.) |

### Sort Options

| Value | Description |
|-------|-------------|
| `default` | Default relevance sorting |
| `price-asc-rank` | Price: low to high |
| `price-desc-rank` | Price: high to low |
| `rating-asc-rank` | Rating: low to high |
| `rating-desc-rank` | Rating: high to low |
| `ratings-asc-rank` | Review count: low to high |
| `ratings-desc-rank` | Review count: high to low |

**Important**: If the requested sort order is not in the supported list above, do NOT attempt to use any other tool or workaround to compensate. Inform the user of the supported sort options.

## Usage

- **API Endpoint**: `POST /amazon/searchByImage` (see `references/api.md` for full parameters, responses, and error codes)
- **Python Script**: `python scripts/amazon_search_by_image.py '<JSON parameters>'`

**Output strategy (script default behavior)**:
- Prints the full JSON response to stdout

**Data reading tip**: Use `jq` or `ConvertFrom-Json` to extract specific fields from the response as needed.

## Usage Examples

**1. Basic image search on the US marketplace**
```
Search Amazon US for products that look similar to this image:
https://m.media-amazon.com/images/I/61pAlIX8SZL._AC_SY575_.jpg
```

**2. Find similar products on a specific marketplace**
```
Search Amazon Germany (amazon.de) for products visually similar to this image:
https://example.com/product-photo.jpg
```

**3. Image search sorted by price (low to high)**
```
Find similar products on Amazon US for this image, sorted by price from low to high:
https://example.com/my-product.jpg
```

**4. Image search with Nexscope data enrichment**
```
Search Amazon US for products matching this image and include Keepa sales data:
https://example.com/competitor-product.jpg
```

**5. Cross-border delivery search**
```
Search Amazon Japan for similar products to this image, with delivery to China:
https://example.com/item.jpg
```

**6. Competitor lookalike discovery**
```
I found this product image on a competitor's listing. Find me all similar-looking products on Amazon UK:
https://example.com/competitor.jpg
```

## Display Rules

1. **Present data clearly**: Show search results in a well-structured table. Key columns to prioritize: product image, title, ASIN, price, rating, review count, and brand
2. **Image display**: When the response includes `imageUrl` for products, display them inline so users can visually compare results
3. **Price and currency**: Always show price alongside the currency code (e.g., $29.99 USD)
4. **Nexscope data**: When `aggregateByKeepaData` is enabled and Nexscope fields are present, show supplementary data (monthly sales, sales rank, FBA fees) in an expanded section or additional columns
5. **Result count**: Always inform the user of the total number of results found
6. **Error handling**: When a query fails, explain the issue and suggest checking that the image URL is valid and publicly accessible
7. **Sort limitation**: If the user requests a sort order not in the supported list, clearly explain which sort options are available rather than attempting unsupported workarounds
8. **No secondary processing**: Results from this tool are not stored in a database, so secondary SQL processing is not available

## User Expression & Scenario Quick Reference

**Applicable** -- Visual product search scenarios on Amazon:

| User Says | Scenario |
|-----------|----------|
| "Find similar products to this image" | Basic image search |
| "Search by image," "reverse image search on Amazon" | Visual search |
| "Find competitor lookalikes," "find same-style products" | Competitor analysis by appearance |
| "What products on Amazon look like this" | Product discovery |
| "Find cheaper alternatives that look the same" | Price-based visual comparison |
| "Search Amazon JP/DE/UK for this product image" | Cross-marketplace visual search |
| "Show me Nexscope data for similar products" | Enriched visual search |
| "Find products similar to this photo, sorted by rating" | Sorted visual search |

**Not applicable** -- Needs beyond image-based product search:

- Text-based keyword search on Amazon (use keyword search tools instead)
- ABA search term data analysis
- Product review analysis or listing optimization
- Sales estimation without a source image
- Image editing or image generation

**Boundary judgment**: When users say "find similar products" or "competitor analysis," if they provide an image URL and the intent is to find visually similar Amazon listings, this skill applies. If they are asking for keyword-based search, sales data analysis, or product research without an image, it does not apply.

## Authentication

Set `NEXSCOPE_API_KEY`. Visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to manage credits.

## API Key request rate

All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.

If an execution request returns HTTP 429 with outer code `13012`, the request-rate allowance was exceeded. Honor the returned `Retry-After` before considering another request. Outer code `13013` means the concurrent-request limit was exceeded, not the rate limit; honor its `Retry-After` when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall