mcpField
Z
zyte

zyte

github.com/zytedata数据与数据库1148 次安装2 天前更新
代码仓库

关于 zyte

zyte 是面向 Zyte API 和云服务的技能,涵盖账户设置、Scrapy Cloud 部署与批量导出、定价和文档问答。它补充 Zyte MCP 未覆盖的任务;作业与用量操作则在 MCP 可用时交由其处理。

主要功能

  1. 01安全引导账户设置与 API 凭据管理
  2. 02部署 Scrapy 项目到 Scrapy Cloud
  3. 03导出作业条目、日志和请求
  4. 04查询 Zyte API 实时定价文档
  5. 05依据官方文档回答产品用法问题

适用场景

  1. 01设置 Zyte API 凭据且不暴露密钥值
  2. 02部署 Scrapy 项目或爬虫
  3. 03将作业条目、日志或请求保存到文件
  4. 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.md
credentials.md
deployment.md
mcp.md
pricing.md
scrapy-cloud.md
scripts/
auth.py
download_key.py
env_keys.py
oauth.py
stack_tags.py

详细介绍

本文件共 92 行;请全部阅读。

下文中的 SKILL_DIR 表示包含本文件的目录的绝对路径。SKILLS_DIR 表示包含所有技能目录的目录,其中一个目录就是 SKILL_DIR。

你是 Zyte API 和云服务的助手。此技能涵盖 Zyte MCP 未涵盖的 Zyte 相关工作:

  1. 凭据和账户设置 — 注册 / 登录并加载 ZYTE_API_KEY 和 SHUB_APIKEY。
  2. Scrapy Cloud 部署和批量导出 — 使用 shub 部署项目,并将某个作业的所有条目、日志或请求导出到文件。
  3. Zyte API 套餐定价 — 根据实时定价文档了解套餐、等级、折扣和功能费用。
  4. 文档和操作指南 — 查阅官方文档,回答关于 Zyte 及其产品(包括 Web 控制面板和账户 / 账单)的一般操作指南、说明或文档问题。

运行、列出、停止和检查 Scrapy Cloud 作业、已记录的 Zyte API 用量以及各网站价格,属于 Zyte MCP 的工具,而非此技能的功能。

输入

原始参数字符串为 $ARGUMENTS——请原样使用;若为空,则视为“未提供参数”。对于部署,此参数为 project_dir:Scrapy 项目目录的路径(如果参数字符串为空,则默认为当前目录)。

路由

阅读 SKILL_DIR/references/ 中与请求匹配的参考文件——且仅阅读这些文件:

请求参考文件
设置、登录、注册、获取 API 密钥;缺少 ZYTE_API_KEY;网站被屏蔽credentials.md
部署项目或爬虫到 Scrapy Clouddeployment.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 中点击操作)。如果任务需要使用控制面板,请说明操作方法并链接相关文档页面,而不是拒绝。

评论

支持 Markdown