Skip to content

nexscope-ai/nexscope-ecommerce-skills / ecommerce-amazon-ads-api-access

ecommerce.amazon-ads-api-access

Verified

Authorize Amazon Ads accounts and inspect safe connection and profile metadata.

FileKindSize
SKILL.mdskill md7.4 KB
manifest.jsonconfig524 B
references/api.jsonconfig6.6 KB
references/api.mdmarkdown7.9 KB
references/testing.mdmarkdown2.3 KB
scripts/amazon_connection.pyscript2.4 KB

references/api.json

View on GitHub
{
  "schemaVersion": 1,
  "package": "ecommerce.amazon-ads-api-access",
  "operationCount": 5,
  "operations": [
    {
      "id": "authorize_url",
      "name": "Authorize Url",
      "product": "CONNECTION",
      "method": "POST",
      "providerPath": "/api/skill/amazon/connections/amazon-ads/authorize",
      "gatewayAction": "authorize",
      "mutation": true,
      "callable": true,
      "executionMode": "specialized",
      "specializedScript": "scripts/amazon_connection.py",
      "legacyOnlyMechanismRemoved": false,
      "backendReplacement": null,
      "sourceAccess": "write",
      "requiredInputs": [
        "region",
        "marketplaceId"
      ],
      "optionalInputs": [
        "accountName",
        "returnPath",
        "workspaceId"
      ],
      "pathInputs": [],
      "queryInputs": [],
      "bodyInputs": [
        "workspaceId",
        "region",
        "marketplaceId",
        "accountName",
        "returnPath"
      ],
      "contentType": "application/json",
      "pagination": null,
      "result": "Safe authorization, connection, or profile metadata without provider credentials.",
      "errors": [
        "invalid input",
        "unauthorized workspace",
        "connection limit",
        "authorization timeout"
      ],
      "statusBehavior": {
        "2xx": "Return safe connection metadata.",
        "400": "Reject invalid authorization input.",
        "401/403": "Reject missing access or workspace ownership.",
        "429": "Retry only with bounded backoff.",
        "5xx": "Exit nonzero."
      }
    },
    {
      "id": "authorized_stores",
      "name": "Authorized Stores",
      "product": "CONNECTION",
      "method": "GET",
      "providerPath": "/api/skill/amazon/connections/amazon-ads",
      "gatewayAction": "connections",
      "mutation": false,
      "callable": true,
      "executionMode": "specialized",
      "specializedScript": "scripts/amazon_connection.py",
      "legacyOnlyMechanismRemoved": false,
      "backendReplacement": null,
      "sourceAccess": "read",
      "requiredInputs": [],
      "optionalInputs": [
        "workspaceId"
      ],
      "pathInputs": [],
      "queryInputs": [
        "workspaceId"
      ],
      "bodyInputs": [],
      "contentType": null,
      "pagination": null,
      "result": "Safe authorization, connection, or profile metadata without provider credentials.",
      "errors": [
        "invalid input",
        "unauthorized workspace",
        "connection limit",
        "authorization timeout"
      ],
      "statusBehavior": {
        "2xx": "Return safe connection metadata.",
        "400": "Reject invalid authorization input.",
        "401/403": "Reject missing access or workspace ownership.",
        "429": "Retry only with bounded backoff.",
        "5xx": "Exit nonzero."
      }
    },
    {
      "id": "profiles",
      "name": "Profiles",
      "product": "CONNECTION",
      "method": "GET",
      "providerPath": "/api/skill/amazon/connections/amazon-ads/profiles",
      "gatewayAction": "profiles",
      "mutation": false,
      "callable": true,
      "executionMode": "specialized",
      "specializedScript": "scripts/amazon_connection.py",
      "legacyOnlyMechanismRemoved": false,
      "backendReplacement": null,
      "sourceAccess": "read",
      "requiredInputs": [
        "connectionId"
      ],
      "optionalInputs": [
        "workspaceId"
      ],
      "pathInputs": [],
      "queryInputs": [
        "workspaceId",
        "connectionId"
      ],
      "bodyInputs": [],
      "contentType": null,
      "pagination": null,
      "result": "Safe authorization, connection, or profile metadata without provider credentials.",
      "errors": [
        "invalid input",
        "unauthorized workspace",
        "connection limit",
        "authorization timeout"
      ],
      "statusBehavior": {
        "2xx": "Return safe connection metadata.",
        "400": "Reject invalid authorization input.",
        "401/403": "Reject missing access or workspace ownership.",
        "429": "Retry only with bounded backoff.",
        "5xx": "Exit nonzero."
      }
    },
    {
      "id": "refresh_token",
      "name": "Refresh Token",
      "product": "CONNECTION",
      "method": "NONE",
      "providerPath": "backend-owned token refresh",
      "gatewayAction": "legacy-only mechanism removed",
      "mutation": false,
      "callable": false,
      "executionMode": "removed",
      "specializedScript": null,
      "legacyOnlyMechanismRemoved": true,
      "backendReplacement": "The backend owns token storage and refresh; use authorization status and connection metadata.",
      "sourceAccess": "write",
      "requiredInputs": [],
      "optionalInputs": [],
      "pathInputs": [],
      "queryInputs": [],
      "bodyInputs": [],
      "contentType": null,
      "pagination": null,
      "result": "Safe authorization, connection, or profile metadata without provider credentials.",
      "errors": [
        "invalid input",
        "unauthorized workspace",
        "connection limit",
        "authorization timeout"
      ],
      "statusBehavior": {
        "2xx": "Return safe connection metadata.",
        "400": "Reject invalid authorization input.",
        "401/403": "Reject missing access or workspace ownership.",
        "429": "Retry only with bounded backoff.",
        "5xx": "Exit nonzero."
      }
    },
    {
      "id": "store_tokens",
      "name": "Store Tokens",
      "product": "CONNECTION",
      "method": "NONE",
      "providerPath": "backend-owned OAuth callback token storage",
      "gatewayAction": "legacy-only mechanism removed",
      "mutation": false,
      "callable": false,
      "executionMode": "removed",
      "specializedScript": null,
      "legacyOnlyMechanismRemoved": true,
      "backendReplacement": "The backend owns token storage and refresh; use authorization status and connection metadata.",
      "sourceAccess": "write",
      "requiredInputs": [],
      "optionalInputs": [],
      "pathInputs": [],
      "queryInputs": [],
      "bodyInputs": [],
      "contentType": null,
      "pagination": null,
      "result": "Safe authorization, connection, or profile metadata without provider credentials.",
      "errors": [
        "invalid input",
        "unauthorized workspace",
        "connection limit",
        "authorization timeout"
      ],
      "statusBehavior": {
        "2xx": "Return safe connection metadata.",
        "400": "Reject invalid authorization input.",
        "401/403": "Reject missing access or workspace ownership.",
        "429": "Retry only with bounded backoff.",
        "5xx": "Exit nonzero."
      }
    }
  ]
}
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall