Sears MCP server for AI agents
Let Claude, ChatGPT or your own agent read Sears: 3 typed functions through one MCP server. No Sears API key needed.
- Site
- sears.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Sears
An MCP server for Sears alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/searsEvery site
One MCP server for Sears and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 3
checkStockAnswers whether a specific product is buyable right now.Arguments
Name Type Required idOrUrlstringYes opts{ zipCode?: string; quantity?: number }No Returns
SearsStockinterface SearsShippingAvailability { available: boolean; availableQuantity: number | null; ffmType: string | null; shipModes: string[]; dcUnitId: string | null; promiseDate: string | null; autoUpgrade: boolean; freeShipping: boolean; freeEligible: boolean; freeQualified: boolean; } interface SearsStockStore { unitId: string | null; storeName: string | null; storeBrand: string | null; storeAddress: string | null; promiseDate: string | null; ffmType: string | null; } interface SearsPickupAvailability { available: boolean; stores: SearsStockStore[]; message: string | null; } interface SearsStock { productId: string; zipCode: string; quantity: number; shipping: SearsShippingAvailability | null; pickup: SearsPickupAvailability; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sears/checkStockCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sears.checkStock("<idOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sears.checkStock("<idOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/sears/checkStock \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sears.checkStock("<idOrUrl>");getProductReads one product in full the way its own product detail page does.Arguments
Name Type Required idOrUrlstringYes opts{ zipCode?: string }No Returns
SearsProductinterface SearsProductPrice { currentAmount: number; currentDisplay: string; regularAmount: number | null; regularDisplay: string | null; onSale: boolean; } interface SearsProductSpecification { label: string; attributes: string[]; } interface SearsProduct { productId: string; url: string; name: string; brand: string | null; price: SearsProductPrice; inStock: boolean; images: string[]; description: string | null; specifications: SearsProductSpecification[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sears/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sears.getProduct("<idOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sears.getProduct("<idOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/sears/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sears.getProduct("<idOrUrl>");searchSearches Sears' live catalog by free-text keyword the way the site's own search bar does, returning matching product rows: id, name, brand, current…Arguments
Name Type Required querystringYes zipCodestringNo limitnumberNo Returns
SearsSearchResult[]interface SearsSearchPrice { currentAmount: number; currentDisplay: string; regularAmount: number | null; regularDisplay: string | null; onSale: boolean; } interface SearsSearchResult { productId: string; url: string; name: string; brand: string | null; price: SearsSearchPrice; thumbnail: string | null; rating: number | null; reviewCount: number | null; totalCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/sears/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.sears.search({ query: "refrigerator" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.sears.search({"query": "refrigerator"}))curl -X POST https://api.bowmark.ai/v1/sites/sears/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"query":"refrigerator"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.sears.search({ query: "refrigerator" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/sears/<function> - OpenAPI
/v1/sites/sears/openapi.json