内容
# TuZonaMarket 购物代理工具包
将 TuZonaMarket 转变为 AI 代理的安全、个人使用的购物工具。代理可以理解购物者的偏好和配送区域，浏览特定区域的目录，构建和审查购物车，并为希望委托耗时购物的用户准备结账。它从不下订单或处理付款。
## 开始使用
您不需要克隆存储库或安装 Node.js。
**Linux 或 macOS**
```bash
curl -fsSL https://raw.githubusercontent.com/AlexR1712/tuzonamarket-agent-toolkit/main/scripts/install.sh | sh
```
**Windows (PowerShell)**
```powershell
irm https://raw.githubusercontent.com/AlexR1712/tuzonamarket-agent-toolkit/main/scripts/install.ps1 | iex
```
安装程序检测您的平台并下载最新的二进制文件。它们将其安装到 Linux/macOS 上的 `~/.local/bin` 或 Windows 上的 `%LOCALAPPDATA%\Programs\TuZonaMarket\bin`。如果提示，请将该目录添加到 `PATH` 中。
首次登录时，请设置您的凭证并使用 CLI：
```bash
export TUZONA_EMAIL='you@example.com'
export TUZONA_PASSWORD='your-password'
tuzona zones
tuzona search arroz --zone carabobo --limit 5
```
`tuzona zones` 列出可用的配送区域。使用服务于用户配送地址的区域，然后为目录、购物车、优惠券和结账命令保留相同的区域。 `--zone` 接受数字 ID、slug 或名称，例如 `2`、`carabobo` 或 `lara`。
在购物车、地址、订单或跟踪等帐户操作之前，请运行 `tuzona login`。CLI 在 Linux/macOS 上将受限的本地 JWT 存储在 `~/.local/state/tuzonamarket/session.json` 中，或在 Windows 上存储在等效的应用程序数据目录中。后续命令在不需环境变量的情况下重用该会话。只有当会话过期且 CLI 需要再次登录时，才重新设置变量。使用 `TUZONA_SESSION_FILE` 或 `--session-file` 选择另一个会话文件位置，并运行 `tuzona logout` 删除它。运行 `tuzona --help` 获取所有命令。购物车、地址和优惠券更改需要 `--yes`。
## 安装代理技能
使用 [skills.sh](https://skills.sh/docs) 在兼容的 AI 代理中安装包含的购物工作流：
```bash
npx skills add AlexR1712/tuzonamarket-agent-toolkit --skill tuzonamarket
```
该技能教导代理如何安装和使用 CLI，选择配送区域，搜索西班牙目录，学习购物偏好以及安全地管理购物车。
## 连接代理
| 设置 | 值 |
| --- | --- |
| MCP URL | `https://tuzonamarket-mcp.blockshift.workers.dev/mcp` |
| 传输 | 流式 HTTP |
| 身份验证 | `Authorization: Bearer ${TUZONA_MCP_BEARER}` |
在代理的安全环境中创建机密：
```bash
export TUZONA_MCP_BEARER="$(printf '%s' "$TUZONA_EMAIL:$TUZONA_PASSWORD" | base64 | tr -d '\n')"
```
`TUZONA_MCP_BEARER` 是 Base64 编码的凭证，而不是加密。不要提交或分享它。包含的技能包含完整的面向代理的 MCP 工作流，包括会话处理、突变确认和错误恢复。
## 安全性
该项目排除了 `POST /usuario/orden/zona/{zoneId}/pagina/{page}/registrar`。它可以准备结账，但不能购买。请始终审查和确认购物车或地址更改后再运行它们。
## 免责声明
这是一个非官方的、个人使用的工具。它与 TuZonaMarket 无关，不受 TuZonaMarket 认可、赞助或批准。TuZonaMarket 名称和标志归其各自所有者所有。
使用此软件风险自负。提供此软件时不附带任何保证，作者和贡献者不对因使用此软件而产生的任何损失、损害、帐户操作、错误的购买准备或其他后果负责，最大程度依照适用法律。 在继续之前，请在 TuZonaMarket 上验证所有信息和操作。
## 开发
使用 Bun 1.3.14+ 修改项目：
```bash
bun install --frozen-lockfile
bun test
bun run test:mcp
bun run typecheck
bun run build:cli
```
`bun run deploy` 部署 Worker 并需要 Cloudflare 凭证。`v*` 标签构建二进制文件并创建 GitHub Release。
## 更多
- [OpenAPI 规范](openapi.yaml)
- [未来代理的技能](skills/tuzonamarket/SKILL.md)
- [发布](https://github.com/AlexR1712/tuzonamarket-agent-toolkit/releases)
- [MIT 许可证](LICENSE)
