Tokopedia MCP
](https://www.npmjs.com/package/@bintangtimurlangit/tokopedia-mcp)  ](https://github.com/bintangtimurlangit/tokopedia-mcp)
A. 模型上下文协议 将AI助手连接到的（MCP）服务器 Tokopedia --印尼的市场——这样他们就可以搜索产品、阅读详细信息、检查商店，并（通过你的会话）管理订单和愿望清单。
语言： 印度尼西亚语
完整参考： 文档 （安装、配置、MCP客户端、开发）。 变更日志： 更改日志.md. 版本控制和发布： docs/RELEASES.md.
______________________________________________________________________
你得到了什么
- stdio传输 --适用于Cursor、Claude Code、Claude Desktop、VS Code以及任何启动本地进程的MCP客户端。
- Tokopedia GraphQL --合理的默认设置（标头、用户代理、印尼语言环境）。
- 内存缓存 --用于重复查找的短TTL。
- TypeScript+Zod --验证工具输入。
- 清除错误 --MCP文本响应，带有身份验证和速率限制提示。
工具
搜索和发现
| 工具 | 说明 |
|---|---|
search_products | 带分页的关键字搜索(page, rows)，排序(orderBy)、条件、评级、价格范围、位置过滤器。 |
get_filters_and_sorts | 查询的有效筛选和排序选项——在收紧之前使用 search_products. |
产品与店铺
| 工具 | 说明 |
|---|---|
get_product_detail | 完整的产品页面数据：定价、描述、变体、库存、评级、图片。 |
get_shop_info | 店铺简介：徽章（金牌/官方）、统计数据、开放时间、位置、网址 |
get_shop_products | 店铺域的分页目录。 |
帐户（需要会话Cookie）
| 工具 | 说明 |
|---|---|
get_order_history | 带过滤器的订单：状态、日期范围(YYYY-MM-DD)，类别，搜索，分页。 |
get_wishlist | 保存的产品。 |
add_to_wishlist | 按ID添加产品 |
remove_from_wishlist | 使用愿望清单ID从中删除项目 get_wishlist. |
搜索和产品工具无需登录即可工作。订单和愿望清单需要浏览器Cookie——将它们复制到 env 或 .env 如下所示。
______________________________________________________________________
先决条件
- Node.js 18或更新版本
安装
来自npm（推荐）
包名称： @bintangtimurlangit/tokopedia-mcp。PATH上的CLI仍然 tokopedia-mcp.
npm install -g @bintangtimurlangit/tokopedia-mcp或者在没有全局安装的情况下运行：
npx -y @bintangtimurlangit/tokopedia-mcp将您的MCP客户端指向 tokopedia-mcp，或使用 npx 和 ["-y", "@bintangtimurlangit/tokopedia-mcp"] 在 args （参见 配置).
来源（此存储库）
git clone https://github.com/bintangtimurlangit/tokopedia-mcp.git
cd tokopedia-mcp
npm install
npm run build回购未提交 build/你必须跑 npm run build 克隆后，再将MCP连接到 build/index.js，或使用 npm start / npm link 和那个 tokopedia-mcp 本地命令。
配置
Cookie→ env
- 登录 tokopedia.com.
- 打开DevTools（F12）→ 应用 → Cookie →
https://www.tokopedia.com. - 对于下面的每个变量，找到cookie 名字 在表格中（例如。
_SID_Tokopedia_)并复制其 价值 进入匹配 **TOKO_*键入您的MCPenv** 块（或在.env如果您使用env文件）。
| Env键 | 浏览器cookie名称 |
|---|---|
TOKO_SID | _SID_Tokopedia_ |
TOKO_UUID_CAS | _UUID_CAS_ |
TOKO_USER_ID | tuid |
TOKO_DID | DID |
TOKO_DID_JS | DID_JS （可选） |
订单/愿望清单的最低要求： TOKO_SID.可选调整： CACHE_TTL_MS （默认值 30000), DEBUG (true / false).
mcpServers 示例（所有env键）
合并到客户端的配置中。用cookie值替换占位符：
{
"mcpServers": {
"tokopedia": {
"command": "npx",
"args": ["-y", "@bintangtimurlangit/tokopedia-mcp"],
"env": {
"TOKO_SID": "paste_value_from_cookie__SID_Tokopedia_",
"TOKO_UUID_CAS": "paste_value_from_cookie__UUID_CAS_",
"TOKO_USER_ID": "paste_value_from_cookie_tuid",
"TOKO_DID": "paste_value_from_cookie_DID",
"TOKO_DID_JS": "paste_value_from_cookie_DID_JS",
"CACHE_TTL_MS": "30000",
"DEBUG": "false"
}
}
}
}游标、克劳德代码、克劳德桌面和其他主机使用相同的 mcpServers 形状--参见 docs/CONFIGURATION.md 对于全局安装，本地 node 路径和客户端特定的文件位置。
______________________________________________________________________
示例提示
一旦服务器连接到您的助手：
- “在Tokopedia上搜索1500万印尼盾以下的游戏笔记本电脑，按畅销书排序。”
- “显示此URL的产品详细信息：…”
- “哪些订单仍在发货？”
- “将ID为…的产品添加到我的愿望清单中。”
发展
贡献与安全
许可证
______________________________________________________________________
法律
该项目是一个非官方的MCP桥梁。它不隶属于Tokopedia或PT Tokopedia，也不受其认可。负责任地使用它，并遵守Tokopedia的服务条款。