nexscope-ai/nexscope-ecommerce-skills / ecommerce-amazon-store-auth
ecommerce.amazon-store-auth
VerifiedGenerate a consent link and manage owned Seller Central connections.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.5 KB |
| manifest.json | config | 397 B |
| references/api.json | config | 4.0 KB |
| references/api.md | markdown | 3.0 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 Authorization API reference
Migration reference: `linkfox-amazon-store-auth` 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 |
| --- | --- | --- |
| `authorize` | `/spapi/authorize` | Authorized connection where required |
| `connection-status` | `/spapi/connectionStatus` | Authorized connection where required |
| `disconnect` | `/spapi/disconnect` | Authorized connection where required |
| `list-connections` | `/spapi/listConnections` | Authorized connection where required |
| `refresh-connection` | `/spapi/refreshConnection` | 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-auth-authorize`
MCP tool: `nexscope_amazon_sp_api_auth_authorize`.
- `marketplaceId` (string, required). Amazon marketplace ID.
- `region` (string, optional). Amazon region inferred from marketplace if omitted.
- `accountName` (string, optional). Optional connection display name.
Illustrative request
```json
{
"marketplaceId": "ATVPDKIKX0DER"
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"authorizationUrl": "https://sellercentral.amazon.com/apps/authorize/consent?state=EXAMPLE_STATE",
"expiresAt": 1893456000000
}
}
```
### `amazon-sp-api-auth-connection-status`
MCP tool: `nexscope_amazon_sp_api_auth_connection_status`.
- `connectionId` (integer, required). Owned Seller connection ID.
Illustrative request
```json
{
"connectionId": 123
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"connection": {
"id": 123,
"status": "CONNECTED",
"revision": 2
}
}
}
```
### `amazon-sp-api-auth-disconnect`
MCP tool: `nexscope_amazon_sp_api_auth_disconnect`.
- `connectionId` (integer, required). Owned Seller connection ID.
- `revision` (integer, required). Current connection revision from status.
- `confirm` (boolean, required). Explicit confirmation to disconnect.
Illustrative request
```json
{
"connectionId": 123,
"revision": 2,
"confirm": true
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"connection": {
"id": 123,
"status": "EXPIRED"
}
}
}
```
### `amazon-sp-api-auth-list-connections`
MCP tool: `nexscope_amazon_sp_api_auth_list_connections`.
Illustrative request
```json
{}
```
Illustrative response
```json
{
"code": 0,
"data": {
"connections": []
}
}
```
### `amazon-sp-api-auth-refresh-connection`
MCP tool: `nexscope_amazon_sp_api_auth_refresh_connection`.
- `connectionId` (integer, required). Owned Seller connection ID.
Illustrative request
```json
{
"connectionId": 123
}
```
Illustrative response
```json
{
"code": 0,
"data": {
"prepared": true,
"expiresAt": 1893456000000
}
}
```
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 |