Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-amazon-store-auth

ecommerce.amazon-store-auth

Verified

Generate a consent link and manage owned Seller Central connections.

FileKindSize
SKILL.mdskill md2.5 KB
manifest.jsonconfig397 B
references/api.jsonconfig4.0 KB
references/api.mdmarkdown3.0 KB
references/testing.mdmarkdown1.1 KB
scripts/amazon_sp_api.pyscript5.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
  }
}
```
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall