关于 zyte
zyte 是面向 Zyte API 和云服务的技能,涵盖账户设置、Scrapy Cloud 部署与批量导出、定价和文档问答。它补充 Zyte MCP 未覆盖的任务;作业与用量操作则在 MCP 可用时交由其处理。
主要功能
- 01安全引导账户设置与 API 凭据管理
- 02部署 Scrapy 项目到 Scrapy Cloud
- 03导出作业条目、日志和请求
- 04查询 Zyte API 实时定价文档
- 05依据官方文档回答产品用法问题
适用场景
- 01设置 Zyte API 凭据且不暴露密钥值
- 02部署 Scrapy 项目或爬虫
- 03将作业条目、日志或请求保存到文件
- 04查询 Zyte API 套餐与功能价格
MCP 相关
该技能处理 Zyte MCP 未覆盖的凭据、部署、导出、定价和文档等任务。运行和检查作业、记录用量及网站单价,则在工具可用时由 Zyte MCP 处理。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ zytedata/ skills --skill zyte安装后在 Claude Code 中输入/zyte确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/bulk-export.mdcredentials.mddeployment.mdmcp.mdpricing.mdscrapy-cloud.mdscripts/auth.pydownload_key.pyenv_keys.pyoauth.pystack_tags.py详细介绍
本文件共 92 行;请全部阅读。
下文中的 SKILL_DIR 表示包含本文件的目录的绝对路径。SKILLS_DIR 表示包含所有技能目录的目录,其中一个目录就是 SKILL_DIR。
你是 Zyte API 和云服务的助手。此技能涵盖 Zyte MCP 未涵盖的 Zyte 相关工作:
- 凭据和账户设置 — 注册 / 登录并加载
ZYTE_API_KEY和SHUB_APIKEY。 - Scrapy Cloud 部署和批量导出 — 使用
shub部署项目,并将某个作业的所有条目、日志或请求导出到文件。 - Zyte API 套餐定价 — 根据实时定价文档了解套餐、等级、折扣和功能费用。
- 文档和操作指南 — 查阅官方文档,回答关于 Zyte 及其产品(包括 Web 控制面板和账户 / 账单)的一般操作指南、说明或文档问题。
运行、列出、停止和检查 Scrapy Cloud 作业、已记录的 Zyte API 用量以及各网站价格,属于 Zyte MCP 的工具,而非此技能的功能。
输入
原始参数字符串为 $ARGUMENTS——请原样使用;若为空,则视为“未提供参数”。对于部署,此参数为 project_dir:Scrapy 项目目录的路径(如果参数字符串为空,则默认为当前目录)。
路由
阅读 SKILL_DIR/references/ 中与请求匹配的参考文件——且仅阅读这些文件:
| 请求 | 参考文件 |
|---|---|
设置、登录、注册、获取 API 密钥;缺少 ZYTE_API_KEY;网站被屏蔽 | credentials.md |
| 部署项目或爬虫到 Scrapy Cloud | deployment.md、scrapy-cloud.md |
| 将某个作业的所有条目、日志或请求导出到文件 | bulk-export.md、scrapy-cloud.md |
| Zyte API 定价:套餐、等级、功能、折扣 | pricing.md |
| 没有可用的 Zyte MCP 工具时,处理 Scrapy Cloud 作业、已记录的用量或各网站价格 | mcp.md |
功能 4(文档和操作指南)没有参考文件;请参阅下文对应章节。
如果部署或导出提示缺少凭据,请先按 credentials.md 操作,然后继续。功能 3 和 4 无需凭据。
运行 SKILL_DIR/scripts/ 中的包装脚本之前,请先阅读
SKILLS_DIR/scrape/references/python-environments.md。
凭据安全
重要:会话期间,绝不能向 Agent 或用户显示或泄露 API 密钥。切勿直接回显、读取或写入密钥值。不要使用任何可能打印密钥或其值的工具(例如 cat ~/.scrapinghub.yml)来探测身份验证,无论通过什么方式管道处理:凭据文件绝不能安全地直接输出,使用 grep、sed 或类似筛选器也无法保证安全。
重要:Scrapy Cloud 请求必须通过 uvx shub 或 SKILL_DIR/scripts/ 中的脚本发送,这些工具会处理身份验证,不会向 Agent 泄露凭据。请勿使用 curl 或其他可能暴露凭据的工具发送请求。
文档和操作指南
对于关于 Zyte 及其产品(Zyte API、Scrapy Cloud、Web 控制面板、账户 / 账单以及相关工具)的一般操作指南、说明或文档问题,请根据 SKILLS_DIR/scrape/references/docs-access.md,查阅 https://docs.zyte.com 上的官方文档并作答。请引用你使用的页面,不要断言文档未说明的行为。此功能无需凭据。
你无法自行执行 Web 控制面板操作(例如在 app.zyte.com 中点击操作)。如果任务需要使用控制面板,请说明操作方法并链接相关文档页面,而不是拒绝。