From instacart-for-agents
Operate and extend the Instacart-native TypeScript API wrapper over a local shared-browser controller.
How this skill is triggered — by the user, by Claude, or both
Slash command
/instacart-for-agents:instacart-apiThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This repository is an Instacart-native API, not a generic commerce API. It wraps a logged-in Instacart.ca browser controller and exposes typed, safe endpoints for state, text, screenshots, analysis, and cart planning.
This repository is an Instacart-native API, not a generic commerce API. It wraps a logged-in Instacart.ca browser controller and exposes typed, safe endpoints for state, text, screenshots, analysis, and cart planning.
Default controller:
PORT=6082 \
START_URL='https://www.instacart.ca/store/?categoryFilter=homeTabForYou' \
USER_DATA_DIR='/home/hermes/shared-browser/profile-instacart' \
HEADLESS=true \
NODE_PATH=/home/hermes/shared-browser/node_modules:/home/hermes/.hermes/hermes-agent/node_modules \
node /home/hermes/shared-browser/server.js
API server:
cd /home/hermes/commerce-api
INSTACART_CONTROLLER_URL=http://127.0.0.1:6082 npm run dev
Use /instacart/*:
GET /healthGET /instacart/stateGET /instacart/textGET /instacart/screenshot.jpgGET /instacart/elementsGET /instacart/analysisGET /instacart/visionGET /instacart/login, /login/statusPOST /instacart/login/start, /login/otpPOST /instacart/gotoPOST /instacart/click, /type, /press, /scroll, /reload, /nav, /click-near-textPOST /instacart/cart-planLegacy /apps/instacart/* aliases exist only for old dashboards. Do not add other app adapters here.
cart-plan must default to checkoutBlocked: true.unknown instead of falling through to another parser./instacart/login/status, then /instacart/login/start, /instacart/login/otp, and verify status again.Run:
npm run check
Before reporting a cart task complete, also hit a live controller if available:
curl -s http://127.0.0.1:7077/health
curl -s http://127.0.0.1:7077/instacart/analysis
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub waleeeeed88/instacart-for-agents --plugin instacart-for-agents