Amazon Ads Report Downloader Skill

What it does

LinkFox's linkfox-amazon-ads-report retrieves Amazon advertising reports for an account you have authorized. Its Python helper creates a report job, polls its status, downloads the result and extracts the data. The reviewed references cover Sponsored Products, Sponsored Brands and Sponsored Display.

This is the data retrieval step. It does not supply a PPC strategy or give access to another seller's private advertising data. Our review covers source files; we have not connected a store or tested a report download.

When to use

Use it when a recurring ad review starts with manually exporting the same campaign or search-term reports. It fits an agency or seller with an authorized LinkFox connection and an agent that can run local Python scripts. For an existing CSV, go directly to the PPC report analyzer.

Inputs

• An authorized Amazon Ads account and marketplace. With multiple matching stores, choose the account explicitly.
• A report type, date range, grouping and selected columns from that type's reference file.
• The linkfox-amazon-ads-auth dependency, vendor credential and a writable local output directory.
• An attribution window and currency that remain consistent during later comparisons.

Outputs

• A reportId, processing status and local file location.
• Structured report data after download and extraction.
• A temporary local download link when enabled. Its lifetime is limited; keep the saved file for subsequent analysis.

Example workflow

Illustrative task, not an executed download: retrieve US Sponsored Products search terms for September 1-7, 2026.

1. Confirm the store through the authorization dependency and resolve its profileId.
2. Select spSearchTerm, SPONSORED_PRODUCTS, groupBy: [searchTerm] and SUMMARY.
3. Read the pinned search-term field reference. Request searchTerm, impressions, clicks, cost, sales7d, startDate and endDate if still supported.
4. Confirm the request and any charges, then let the helper create and poll the job.
5. If it remains STILL_PROCESSING, retain the reportId and decide whether to wait longer. A timeout does not prove that Amazon rejected the job.
6. Check the saved rows and date range before passing them to the offline HTML report Skill.

Supported agents and setup

The source describes use in Claude Code and requires Python, supporting scripts and reference files. Review the complete report Skill and its authorization dependency together; downloading only SKILL.md is insufficient. Other clients require their own environment verification. No installation or account authorization was performed for this listing.

Account, API, and permission requirements

A LinkFox account, its API credential and Amazon Ads authorization are required. An Ecommerce Data API key cannot replace these. The workflow makes network requests, creates remote report jobs, handles credentials and writes local files. Its source also requests automatic vendor feedback: review that behavior and require approval before transmitting feedback or business data.

The source code has an MIT license. Vendor services may have separate charges. The reviewed Skill contains conflicting statements about usage credits, so confirm current billing before use; the directory price category does not promise free report retrieval.

Limits and human review boundary

• Report fields, retention and date limits vary by type. The reviewed spSearchTerm reference specifies a 31-day range and 65-day retention; recheck the current reference before requesting older data.
• Search-term reports exclude impressions without an ad click. Do not use their rows as a complete impression inventory.
• Empty data can mean no activity. Delayed attribution can change recent metrics.
• This Skill does not cover DSP, Sponsored Television, Brand Analytics or Retail Analytics. It creates reports, not campaign bid changes.
• Review authorization scope, downloaded data and local link sharing. Do not retry failed jobs indefinitely or send secrets through prompts.

Pair with Ecommerce Data API

Use your own ad report to identify search terms, then supplement them with Amazon keyword research and traffic analysis. Public market data adds context; it does not replace your spend, orders or advertising attribution.

Create an Ecommerce Data API key only for that additional market research. Browse the Amazon PPC Skills collection for the next analysis step.

Source review

Discovered on Skills.sh. Source, report schema, helper and license were inspected at commit 38fef046 on September 15, 2026. This is an independent directory entry, not an endorsement by Amazon or an installation/security certification.