shipstation-orders
Monitor ShipStation orders, detect issues, and send alerts. For e-commerce businesses using ShipStation for order fulfillment across multiple platforms (Amazon, Etsy, Shopify, TikTok, etc.).
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- shipstation-orders
- metadata
- { "openclaw": { "requires": { "env": [ "SHIPSTATION_API_KEY", "SHIPSTATION_API_SECRET" ], "bins": [ "node" ] } } }
- description
- Monitor ShipStation orders, detect issues, and send alerts. For e-commerce businesses using ShipStation for order fulfillment across multiple platforms (Amazon, Etsy, Shopify, TikTok, etc.).
03 SKILL.md 正文
ShipStation Order Monitor
Monitor ShipStation for new orders and issues. Perfect for e-commerce businesses using ShipStation to aggregate orders from multiple marketplaces.
Features
- ✅ New order notifications
- ⚠️ Alert for orders stuck in processing (>48h)
- 🛑 Flag orders on hold
- 🚚 Immediate alert for expedited/2-day/priority orders
- 📊 Daily summary reports
- 🔄 Automatic state tracking (avoids duplicate alerts)
Requirements
- ShipStation account with API access
- Node.js (included with OpenClaw)
Setup
1. Get ShipStation API Credentials
- Log into ShipStation
- Go to Settings → Account → API Settings
- Use Legacy API (V1) - generate API Key + API Secret
2. Configure Credentials
Create .env file in your workspace:
SHIPSTATION_API_KEY=your_api_key_here
SHIPSTATION_API_SECRET=your_api_secret_here
3. Test the Monitor
node check-orders.js
Output shows:
- Total orders in last 24h
- New orders detected
- Any alerts
Exit codes:
0- Success, no alerts1- Success, alerts found2- Error (API failure, bad credentials)
4. Set Up Heartbeat Monitoring (Optional)
Add to your agent's HEARTBEAT.md:
## Check Orders
Every 15 minutes:
1. Run: `node check-orders.js`
2. Parse results
3. If new orders or alerts → notify via sessions_send
4. If nothing → HEARTBEAT_OK
Or use a cron job for scheduled checks.
Usage
Manual Check
node check-orders.js
In Agent Heartbeat
const { exec } = require('child_process');
exec('node check-orders.js', (error, stdout, stderr) => {
const results = JSON.parse(stdout);
if (results.newOrdersList.length > 0) {
// Notify about new orders
}
if (results.alerts.length > 0) {
// Notify about issues
}
});
Alert Conditions
New Orders:
- Any order in
awaiting_shipmentorawaiting_paymentstatus
Issues Flagged:
- Orders awaiting shipment > 48 hours
- Orders on hold (payment verification, address issues, etc.)
API Errors:
- Authentication failures
- Rate limit exceeded
- Network issues
State Management
The script maintains state.json to track:
- Last check timestamp
- Processed order IDs (prevents duplicate alerts)
- Pending alerts
- Inventory warnings (future feature)
State file auto-prunes to last 1000 orders.
Customization
Edit check-orders.js to adjust:
Alert Thresholds:
// Line ~70: Change from 48 hours to 24 hours
if (order.orderStatus === 'awaiting_shipment' && ageHours > 24) {
Time Window:
// Line ~60: Change from 24 hours to 12 hours
const yesterday = new Date(Date.now() - 12 * 60 * 60 * 1000).toISOString();
Additional Checks: Add custom logic for your business needs (high-value orders, specific products, etc.)
API Reference
Uses ShipStation API V1
Rate Limits:
- 40 requests per minute
- Script uses 1 request per check
Key Endpoints Used:
GET /orders?modifyDateStart={date}&pageSize=100
Troubleshooting
Error: "API credentials not configured"
- Check
.envfile exists in same directory - Verify credentials don't contain placeholder text
Error: "ShipStation API error: 401"
- Credentials are incorrect
- Regenerate API key in ShipStation
Error: "ShipStation API error: 429"
- Rate limit exceeded
- Reduce check frequency
No new orders detected but they exist:
- Check
modifyDateStartwindow (default: 24h) - Verify orders have been modified recently in ShipStation
- Check
state.json- might already be processed
Files
check-orders.js- Main order monitoring scriptcheck-shipping.js- Expedited shipping alert monitorstate.json- Auto-generated order state trackingshipping-state.json- Auto-generated shipping state tracking.env- Your credentials (add to .gitignore!)
License
MIT
Author
Built for OpenClaw multi-agent systems.
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.