🛍️ Sheypoor MCP

Model Context Protocol server for Sheypoor — Iran's largest classifieds marketplace.

Search listings · Get product details · Manage your account · Chat · Bookmark — all from Claude, Cursor, or any MCP host.

What is this?

sheypoor-mcp is an MCP server that exposes the Sheypoor marketplace as tools an LLM can call. Ask Claude:

"Find the 5 cheapest iPhone 15 Pro Max in Tehran with images."

…and it will chain list_provinces → search_listings → get_listing → produce a table.

Related MCP server: divar-mcp

Preview

Quick start (recommended)

Use the hosted Cloudflare Worker — no install needed:

Remote URL: https://sheypoor-mcp.farhamaghdasi.workers.dev/

MCP host config

Any MCP host that supports remote HTTP/SSE transport. Point it at:

{
  "mcpServers": {
    "sheypoor": {
      "type": "remote",
      "url": "https://sheypoor-mcp.farhamaghdasi.workers.dev/"
    }
  }
}

Restart your MCP host after saving. The tools should appear automatically.

Local install

If you prefer running it locally, or want to develop:

git clone https://github.com/farhamaghdasi/sheypoor-mcp.git
cd sheypoor-mcp
pnpm install
pnpm build
node dist/bin.js

Then point your MCP host at node dist/bin.js as a local stdio command.

From source (development)

git clone https://github.com/farhamaghdasi/sheypoor-mcp.git
cd sheypoor-mcp
pnpm install
pnpm typecheck
pnpm test
pnpm lint
pnpm build

Layout:

src/
├── bin.ts              CLI entry
├── index.ts            public exports
├── client/             HTTP client (reusable without MCP)
├── mcp/                MCP server (tools, resources, prompts)
└── util/               logger, throttle, paths
tools/legacy-py/        frozen Python reference
docs/                   architecture + API notes

Tools

Resources

• sheypoor://categories

• sheypoor://locations

• sheypoor://versions

Prompts

• find_cheapest

• analyze_listing

• market_snapshot

• compare_listings

Configuration

All config is via environment variables:

Example:

{
  "mcpServers": {
    "sheypoor": {
      "command": "npx",
      "args": ["-y", "sheypoor-mcp"],
      "env": {
        "SHEYPOOR_COOKIE_FILE": "/Users/me/.config/sheypoor-mcp/cookies.json",
        "SHEYPOOR_LOG_LEVEL": "debug"
      }
    }
  }
}

Programmatic use

import { SheypoorClient } from "sheypoor-mcp";

const cli = new SheypoorClient();

// Search
const page = await cli.search.page({ q: "آیفون", city: "tehran", sort: "cheapest" });
for (const listing of cli.search.extractListings(page)) {
  console.log(listing.id, listing.title);
}

// Detail
const detail = await cli.listing.detail("466838381");
console.log(detail.title, detail.phone, detail.images.length);

// Auth
const pending = await cli.auth.start("09000000000");
// ... user receives SMS ...
const tokens = await cli.auth.complete(pending, "1234");
console.log("Logged in:", tokens.userName);

Cloudflare Worker

The Worker is deployed at https://sheypoor-mcp.farhamaghdasi.workers.dev/.

To deploy your own:

wrangler deploy

See wrangler.toml for configuration. The Worker uses WebStandardStreamableHTTPServerTransport and in-memory cookies by default. For persistent cookies, configure a KV binding in wrangler.toml.

Legal

Not affiliated with Sheypoor. Reverse-engineered from public traffic. Respect robots.txt and Sheypoor's Terms of Service. Do not scrape personal data, do not spam, and do not use the analytics endpoint (track_click) unless simulating a genuine user.

License

MIT