track17

What This Skill Does

The track17 skill enables your Clawdbot to serve as an intelligent, automated parcel tracking assistant. By integrating with the 17TRACK API v2.2, this skill maintains a synchronized local SQLite database of your shipments. It is designed for users who need to manage multiple packages across various carriers without manually checking multiple websites. It supports both active polling for updates and passive ingestion of webhook payloads, allowing for real-time notifications when a parcel status changes (e.g., in transit, out for delivery, or delivered).

Installation

To integrate this skill into your environment, use the OpenClaw management tool: clawhub install openclaw/skills/skills/tristanmanchester/track17. Once installed, ensure you have your TRACK17_TOKEN configured in your environment variables. Run python3 {baseDir}/scripts/track17.py init to generate the local SQLite database. The skill automatically maps the workspace directory to store your tracking data securely. For advanced users, optional configuration variables like TRACK17_WEBHOOK_SECRET and TRACK17_DATA_DIR allow for custom directory management and webhook verification security.

Use Cases

• Automated Order Tracking: Automatically poll and summarize the status of multiple e-commerce shipments from platforms like AliExpress or Amazon.
• Logistics Monitoring: Keep a persistent log of incoming business inventory or hardware deliveries directly within your local workspace.
• Webhook-Based Notification Systems: Integrate with 17TRACK's real-time push notifications to receive instant updates the moment a parcel is scanned by a courier.
• Centralized Status Reporting: Maintain a clean, queryable local history of all shipped items, including the ability to stop, restart, or remove tracking entries on demand.

Example Prompts

1. "Track this new package for me: RR123456789CN, labeled 'New Keyboard', and add it to my list."
2. "Show me the status of my second package. Is it out for delivery yet?"
3. "Run a sync on all my tracked items to see if there are any new shipping updates."

Tips & Limitations

• Token Management: Always keep your TRACK17_TOKEN secure; it is the primary authentication key for the 17TRACK API.
• Carrier Codes: While the tool attempts auto-detection, some obscure carriers require manual code specification. Use the --carrier flag if the tool fails to identify the shipping company.
• Quota Awareness: The 17TRACK API has usage limits. Use the quota command periodically to ensure you are staying within your plan limits.
• Local Data: The SQLite database is local to your workspace. Back up the directory periodically if you require a long-term historical record of all your deliveries.