A robust tool for downloading and querying Amazon order history through an unofficial Python API and CLI interface.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install amazon-orders
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install amazon-orders using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Amazon Orders Skill?
The Amazon Orders skill enables developers and power users to interact with their Amazon.com order history without needing an official API. By leveraging the amazon-orders Python package, this skill scrapes and parses the Amazon consumer website to retrieve detailed transaction records. It is a vital component for anyone using Openclaw Skills to build personal finance trackers, inventory systems, or automated expense reports.
This skill supports the English version of Amazon.com and provides a seamless way to bridge web-based consumer data with local development environments. Whether you are a developer looking for a Python library or a sysadmin needing a CLI tool, this skill offers the flexibility to handle complex order data efficiently.
Amazon Orders Skill Use Cases
- Exporting annual purchase history to JSON for tax or budgeting purposes.
- Automating the retrieval of business expenses from the last 30 days.
- Monitoring personal spending habits through programmatic data analysis.
- Integrating Amazon order metadata into custom databases or productivity dashboards.
How Amazon Orders Skill Works
- The skill initializes an AmazonSession using your account credentials or environment variables.
- If MFA is enabled, it uses the provided OTP secret key to generate a time-based one-time password.
- It authenticates with Amazon.com and maintains a session for data retrieval.
- The AmazonOrders class parses the HTML of the order history pages to extract structured data.
- Users can specify time filters or request full details to increase the depth of the returned information.
Amazon Orders Skill Setup
To integrate this into your environment using Openclaw Skills, first install the package:
python3 -m pip install --upgrade amazon-orders
Next, configure your authentication credentials. Using environment variables is the recommended method for security:
export AMAZON_USERNAME="[email protected]"
export AMAZON_PASSWORD="your-password"
# Recommended for automation
export AMAZON_OTP_SECRET_KEY="BASE32_TOTP_SECRET"
Amazon Orders Skill Data Schema & Taxonomy
The skill returns structured data that can be output as JSON. Below are the primary fields available when querying order history:
| Field | Description |
|---|---|
| order_number | The unique alphanumeric identifier for the Amazon order. |
| grand_total | The total cost of the order including tax and shipping. |
| order_date | The date the order was placed. |
| items | A list of specific products within the order (requires full_details). |
| status | The current delivery or processing status of the order. |
Amazon Orders Skill Advanced Features
- Full Detail Extraction: Use the --full-details flag to retrieve deeper metadata beyond basic summaries.
- Time-Based Filtering: Quickly fetch records from the last 30 days, past 3 months, or specific calendar years.
- MFA Automation: Built-in support for TOTP secret keys allows for completely headless and automated runs.
- Pipe-Friendly CLI: Output order data directly to jq or other CLI tools for advanced data processing and transformation.
SKILL.md
Loading
Related Openclaw Skills
Capability Awareness System
An automated discovery system that allows agents to identify and load custom skill documentation on demand.
Browser Automation
A natural language browser automation skill that enables AI agents to navigate web pages, extract data, and interact with web elements via the CLI.
Browserbase Functions: Serverless Browser Automation
A comprehensive skill for deploying, managing, and invoking serverless browser automation using the Browserbase CLI and SDK.
Browser Automation Skill
A natural language interface for automating browser actions, web navigation, and data extraction via CLI.
Arccos Golf Performance Analyzer
Analyze your Arccos Golf performance data, including strokes gained and club distances, through a powerful command-line interface.
Email Intelligence
A smart email analysis tool that transforms inbox clutter into actionable health metrics using weather metaphors and debt scoring.
Featured*
