nexscope-ai/nexscope-ecommerce-skills / ecommerce-amazon-product-research-api
ecommerce.amazon-product-research-api
VerifiedRoute Amazon product-selection work across market, keyword, competitor, trend, review, and profitability capabilities. Use this skill when the user asks for this exact ecommerce workflow, analysis, data lookup, or deliverable.
references/amazon-search-by-image.md
View on GitHub# Amazon Search By Image
This reference covers the image-search workflow for `ecommerce.amazon-product-research-api`.
## Purpose
Upload a user-provided product image through the shared Nexscope asset service, then use its confirmed public URL to run Amazon product discovery.
## Operational Guidance
1. When the user supplies a local image, obtain explicit mutation confirmation and run `scripts/upload_image.py`.
2. The upload script calls `POST /api/skill-asset/presign`, uploads the image with `PUT` to the returned presigned HTTPS URL, and calls `POST /api/skill-asset/confirm`.
3. Pass only the confirm response's `publicUrl` to the `amazon_search_by_image` operation.
4. Route the returned products through only the additional market, keyword, review, or competitor operations required by the user's request.
5. Keep source facts, derived values, assumptions, and recommendations distinguishable.
## Contract Rules
- Use `api.json` as the machine-readable operation catalog and `api.md` for invocation details.
- The presign request contains `fileName`, `contentType`, and `fileSize`.
- The confirm request contains `ossKey`, `expectedSize`, and `expectedSha256`.
- Never derive a public image URL by stripping query parameters from the presigned upload URL.
- Never send `NEXSCOPE_API_KEY` to the presigned upload host.
- Validate required identifiers and record missing evidence instead of inventing results.
## Preserved Source Terms
- Request body: JSON.
- `asin`: string, Amazon Standard Identification Number.
- `urlSlug`: string, Nexscope URL slug when required by the selected operation.
## Important Limitations
- Do not fabricate marketplace data or silently fill required business identifiers.
- Do not retry a mutation after an ambiguous timeout; query status first.
- Treat legal, compliance, tax, and profitability outputs as decision support, not professional advice.
- Do not claim real-account, sandbox, ZIP-install, or production validation unless that evidence exists.
## References
- Read `references/workflow.md` before executing the domain procedure.
- Read `references/api.md` for the package contract and examples.
- Read `references/testing.md` before claiming a validation level.
## Privacy and Errors
Treat marketplace, account, product, advertising, order, supplier, and generated-asset data as private. Keep credentials out of payloads and artifacts. Surface HTTP, application-envelope, upstream-business, malformed-response, and unavailable-connector failures distinctly.
## Authentication
Set the `NEXSCOPE_API_KEY` environment variable. If credentials are missing or expire, visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to top up credits.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Unverified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |