Shopping MCP Server (Amazon + Target)

# Target MCP Server Integration - Complete! ✅ ## What Was Built Successfully integrated Target.com support into your existing Amazon MCP server, creating a unified **Shopping MCP Server**. ### New Files Created: 1. **`src/target-config.ts`** - Target configuration and cookie loading 2. **`src/target-utils.ts`** - Puppeteer utilities for Target.com 3. **`src/target-orders.ts`** - Target order history scraper with API interception 4. **`targetCookies.example.json`** - Template for Target cookies 5. **`README-SHOPPING.md`** - Updated documentation ### Modified Files: 1. **`package.json`** - Renamed to "mcp-server-shopping" 2. **`src/index.ts`** - Added `get-target-orders-history` tool 3. Build scripts updated for Windows compatibility ## How Target Integration Works ### The Smart Approach: API Interception Instead of scraping HTML like Amazon, the Target implementation: 1. **Launches Puppeteer browser** with your Target cookies 2. **Navigates to** `https://www.target.com/orders` 3. **Intercepts the API response** from Target's internal API (`guest_order_aggregations/v1/order_history`) 4. **Extracts clean JSON data** directly - no HTML parsing needed! 5. **Supports pagination** - automatically fetches all pages ### Data Structure Retrieved: ```typescript { orderNumber: "912002895833290", orderDate: "2025-10-14T14:26:16-05:00", total: "58.78", orderType: "Sales", items: [ { tcin: "78099947", // Target product ID description: "Unsalted Roasted Mixed Nuts...", quantity: 1, fulfillmentType: "ShipToHome", fulfillmentMethod: "SCHEDULED_DELIVERY", status: "STAT_SHOPPER_CLAIMED", statusDate: "2025-10-14T14:31:48-05:00", isReturnable: false, isCancellable: false } ] } ``` ## Next Steps to Use It ### 1. Export Target Cookies ```bash # 1. Go to target.com and log in # 2. Open Cookie-Editor extension # 3. Click "Export" → "Export as JSON" # 4. Save to: targetCookies.json ``` ### 2. Update Claude Desktop Config Edit: `%APPDATA%\Claude\claude_desktop_config.json` ```json { "mcpServers": { "shopping": { "command": "node", "args": [ "C:\\Users\\YOUR_USERNAME\\source\\repos\\mcp-server-shopping\\build\\index.js" ] } } } ``` ### 3. Restart Claude Desktop Completely close and reopen (check system tray). ### 4. Try It! Ask Claude: - "Show me my Target order history" - "What did I buy from Target recently?" - "Compare my Amazon and Target orders from this month" ## Available Tools Now ### Amazon Tools (Existing): - `get-orders-history` - With year filtering and return status - `get-cart-content` - View cart - `add-to-cart` - Add items - `clear-cart` - Clear cart - `search-products` - Search - `get-product-details` - Product info ### Target Tools (New!): - `get-target-orders-history` - Get all orders with full details ✅ ## Technical Highlights 1. **Clean API Integration** - No HTML parsing, direct JSON from Target's APIs 2. **Automatic Pagination** - Fetches all pages automatically 3. **Rich Data** - Includes fulfillment status, return eligibility, delivery tracking 4. **Unified Server** - One MCP server for both Amazon and Target 5. **Windows Compatible** - Fixed all path and build issues ## Why This Approach is Better **Target vs Amazon Implementation:** | Feature | Amazon | Target | |---------|--------|--------| | Method | HTML Scraping | API Interception | | Data Quality | Parse HTML | Direct JSON | | Reliability | Fragile if HTML changes | More stable | | Speed | Slower (HTML parsing) | Faster (JSON) | | Data Richness | Limited by HTML | Full API data | The Target implementation is actually **cleaner and more reliable** than the Amazon one! ## Future Enhancements Easy to add: - 🔜 Target product search (intercept search API) - 🔜 Target cart management - 🔜 Order tracking details - 🔜 Filter by date range - 🔜 Filter by status All would follow the same API interception pattern! ## Status: READY TO TEST! 🎉 The server is built and ready. Just need to: 1. Export your Target cookies 2. Update Claude config 3. Restart Claude 4. Ask about your Target orders!