V
viztfxyz/handcart
Unofficial Blinkit client: search, cart, checkout and UPI pay, as a CLI, library and MCP server
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"viztfxyz-handcart": {
"command": "npx",
"args": ["handcart"]
}
}
}Parsed from the README we fetched on 2026-10-27; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"viztfxyz-handcart": {
"command": "npx",
"args": ["handcart"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio viztfxyz-handcart -- npx handcart
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 12 ★ · viztfxyz/handcart · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-10-27 · last seen 2026-11-14 · seen 20× · listed by 1 sources
- Score
- score 103 · 12 ★ · 1 sources · repo
- Install
npx handcart
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx handcart. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: 开源项目. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
viztfxyz/handcart；first catalogued 2026-10-27；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# handcart
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
One cart for India's quick-commerce apps. Search across Blinkit and
Zepto at once, compare prices for the same product, then cart, checkout and pay with
UPI on whichever is cheaper — as a CLI, a TypeScript library, and an MCP server for Claude,
Cursor and other agents.
console
$ handcart search "surf excel"
surf excel · 2 platforms
Surf Excel Matic Top Load Liquid Detergent · 5 kg
zepto ₹601 MRP ₹810 -26% in stock a3e1b947-86b8-4311-ab00-8b47928c8b0a
blinkit ₹629 MRP ₹810 -22% in stock 763523
handcart zepto cart add a3e1b947-86b8-4311-ab00-8b47928c8b0a
Payment is headless on both platforms. The UPI QR is handed to whoever pays either as a
qrbaton pay page (items, bill, delivery address, one-tap GPay / PhonePe /
Paytm) or as a plain QR image.
> [!WARNING]
> Not affiliated with, endorsed by, or supported by Blinkit, Zepto or Zomato. It talks to the same private
> endpoints their apps use, which can change or break at any time, and automated use may be against their
> terms. Use it for your own accounts, at your own risk. Real orders and real money are involved:
> pay only proceeds when you pass the exact amount checkout showed.
## Requirements
Node.js ≥ 22
A Chromium-based browser, auto-detected. Zepto needs it to mint its WAF token at login; Blinkit only
needs it for pay --browser.
## Install
bash
npm install -g handcart
handcart setup # guided: browser, logins, delivery addresses, then doctor
Or run it without installing: npx handcart search milk.
As a library: npm install handcart. To hack on it, see CONTRIBUTING.md.
## Platforms
| Platform | search | cart → checkout → pay | orders | categories / browse / locate |
| blinkit | ✓ | ✓ | | ✓ |
| zepto | ✓ | ✓ | ✓ | |
handcart platforms prints this for your machine, with each platform's login and delivery address.
A platform only advertises what it can actually do, so commands it doesn't support don't appear in
--help for it, and a fan-out that skips it says so.
## CLI
Leave the platform out and the command fans out across every platform; name one to narrow it.
bash
handcart search "amul taaza 500ml" # every platform, grouped and price-compared
handcart zepto search paneer # just Zepto
handcart cart # every cart you have open
handcart orders # merged, newest first
handcart whoami # login + delivery address per platform
handcart doctor # what isn't ready, and the command that fixes it
handcart location 560034 # one pincode, applied to every platform
Writes and anything needing a platform-specific product id always name the platform:
bash
handcart zepto login 98xxxxxxxx # SMS OTP
handcart zepto address use home # label, id, or part of the address
handcart zepto cart add -q 2
handcart zepto checkout # payable bill for that address
handcart zepto pay --confirm 642 # the exact amount checkout showed
Every listing command takes --json. handcart --help lists all options.
> [!TIP]
> A price comparison is only meaningful when both platforms deliver to the same place. Run
> handcart location first — handcart whoami will show if they disagree.
### Cross-platform search
handcart search groups what it believes is the same product and marks the cheapest in-stock row with
, followed by a paste-ready add command for that row. Product ids stay visible because every write
Zepto at once, compare prices for the same product, then cart, checkout and pay with
UPI on whichever is cheaper — as a CLI, a TypeScript library, and an MCP server for Claude,
Cursor and other agents.
console
$ handcart search "surf excel"
surf excel · 2 platforms
Surf Excel Matic Top Load Liquid Detergent · 5 kg
zepto ₹601 MRP ₹810 -26% in stock a3e1b947-86b8-4311-ab00-8b47928c8b0a
blinkit ₹629 MRP ₹810 -22% in stock 763523
handcart zepto cart add a3e1b947-86b8-4311-ab00-8b47928c8b0a
Payment is headless on both platforms. The UPI QR is handed to whoever pays either as a
qrbaton pay page (items, bill, delivery address, one-tap GPay / PhonePe /
Paytm) or as a plain QR image.
> [!WARNING]
> Not affiliated with, endorsed by, or supported by Blinkit, Zepto or Zomato. It talks to the same private
> endpoints their apps use, which can change or break at any time, and automated use may be against their
> terms. Use it for your own accounts, at your own risk. Real orders and real money are involved:
> pay only proceeds when you pass the exact amount checkout showed.
## Requirements
Node.js ≥ 22
A Chromium-based browser, auto-detected. Zepto needs it to mint its WAF token at login; Blinkit only
needs it for pay --browser.
## Install
bash
npm install -g handcart
handcart setup # guided: browser, logins, delivery addresses, then doctor
Or run it without installing: npx handcart search milk.
As a library: npm install handcart. To hack on it, see CONTRIBUTING.md.
## Platforms
| Platform | search | cart → checkout → pay | orders | categories / browse / locate |
| blinkit | ✓ | ✓ | | ✓ |
| zepto | ✓ | ✓ | ✓ | |
handcart platforms prints this for your machine, with each platform's login and delivery address.
A platform only advertises what it can actually do, so commands it doesn't support don't appear in
--help for it, and a fan-out that skips it says so.
## CLI
Leave the platform out and the command fans out across every platform; name one to narrow it.
bash
handcart search "amul taaza 500ml" # every platform, grouped and price-compared
handcart zepto search paneer # just Zepto
handcart cart # every cart you have open
handcart orders # merged, newest first
handcart whoami # login + delivery address per platform
handcart doctor # what isn't ready, and the command that fixes it
handcart location 560034 # one pincode, applied to every platform
Writes and anything needing a platform-specific product id always name the platform:
bash
handcart zepto login 98xxxxxxxx # SMS OTP
handcart zepto address use home # label, id, or part of the address
handcart zepto cart add -q 2
handcart zepto checkout # payable bill for that address
handcart zepto pay --confirm 642 # the exact amount checkout showed
Every listing command takes --json. handcart --help lists all options.
> [!TIP]
> A price comparison is only meaningful when both platforms deliver to the same place. Run
> handcart location first — handcart whoami will show if they disagree.
### Cross-platform search
handcart search groups what it believes is the same product and marks the cheapest in-stock row with
, followed by a paste-ready add command for that row. Product ids stay visible because every write
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/viztfxyz-handcart/)
- Source
- github · https://github.com/viztfxyz/handcart
- Browse by field
- Open source
- Traction
- 12 ★
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.