Skip to content

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

ecommerce.amazon-ads-reporting-api

Verified

Create, poll, resume, download, and save Amazon Ads v3 reports.

FileKindSize
SKILL.mdskill md7.0 KB
manifest.jsonconfig547 B
references/ads-report-types.jsonconfig288.8 KB
references/api.jsonconfig3.1 KB
references/api.mdmarkdown4.0 KB
references/testing.mdmarkdown2.7 KB
scripts/amazon_ads_report_workflow.pyscript11.8 KB

references/api.json

View on GitHub
{
  "schemaVersion": 1,
  "package": "ecommerce.amazon-ads-reporting-api",
  "operationCount": 1,
  "operations": [
    {
      "id": "get_report",
      "name": "Get Report",
      "product": "ADS",
      "method": "POST",
      "providerPath": "/reporting/reports",
      "gatewayAction": "ADS_REPORT_START -> ADS_REPORT_POLL -> ADS_REPORT_DOWNLOAD",
      "callable": true,
      "executionMode": "specialized",
      "specializedScript": "scripts/amazon_ads_report_workflow.py",
      "legacyOnlyMechanismRemoved": false,
      "backendReplacement": null,
      "mutation": false,
      "sourceAccess": "write",
      "requiredInputs": [
        "connectionId"
      ],
      "optionalInputs": [
        "reportId",
        "reportTypeId",
        "adProduct",
        "groupBy",
        "columns",
        "name",
        "startDate",
        "endDate",
        "timeUnit",
        "format",
        "filters",
        "configuration",
        "timeoutSeconds",
        "pollIntervalSeconds",
        "outputFile",
        "overwrite",
        "workspaceId"
      ],
      "pathInputs": [],
      "queryInputs": [],
      "bodyInputs": [
        "name",
        "startDate",
        "endDate",
        "configuration"
      ],
      "directBodyInput": null,
      "bodyWrapper": null,
      "batchTransformer": null,
      "batchMaxItems": null,
      "contentType": "application/vnd.createasyncreportrequest.v3+json",
      "queryParameterMap": {},
      "commaSeparatedQueryInputs": [],
      "firstOnlyQueryInputs": [],
      "sdFilterModes": {},
      "clientSideFilters": {},
      "defaults": {},
      "requiredInputSets": [
        [
          "reportId"
        ],
        [
          "startDate",
          "endDate",
          "configuration"
        ],
        [
          "startDate",
          "endDate",
          "reportTypeId",
          "adProduct",
          "groupBy",
          "columns"
        ]
      ],
      "mutuallyExclusiveGroups": [],
      "dependentInputs": {},
      "maxItems": {},
      "numericRanges": {},
      "enumInputs": {},
      "conditionalInputs": {},
      "pagination": null,
      "extendedProviderPath": null,
      "result": "Unwrapped provider response data; non-success application and upstream statuses exit nonzero.",
      "errors": [
        "invalid input",
        "unauthorized connection",
        "rate limit",
        "upstream failure",
        "non-JSON response"
      ],
      "statusBehavior": {
        "2xx": "Return normalized provider data and execution metadata.",
        "400": "Reject invalid path, query, body, or operation-specific constraints.",
        "401/403": "Reject missing access or account ownership.",
        "404": "Return missing provider resource.",
        "409": "Return provider state conflict.",
        "429": "Stop or retry with bounded backoff.",
        "5xx": "Exit nonzero with a sanitized upstream failure.",
        "425": "Recover a duplicate report ID when supplied and resume polling."
      },
      "sourceAccessMeaning": "write means the provider uses HTTP POST to create a read-only report job; mutation is false, so no write confirmation is required."
    }
  ]
}
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