zyte について
zyteは、Zyte APIとクラウドサービスを扱うスキルで、アカウント設定、Scrapy Cloudへのデプロイと一括エクスポート、料金、ドキュメントの質問に対応します。Zyte MCPが扱わない作業を補完し、ジョブや使用量の操作はMCPが利用可能な場合にそちらへ振り分けます。
主な機能
- 01APIキーを露出させないアカウント設定案内
- 02Scrapy Cloudへのプロジェクトのデプロイ
- 03ジョブのアイテム、ログ、リクエストのエクスポート
- 04Zyte APIの最新料金ドキュメントの確認
- 05公式ドキュメントに基づく製品の使い方の案内
活用シーン
- 01キーの値を見せずにZyte APIの認証情報を設定
- 02Scrapyプロジェクトやスパイダーをデプロイ
- 03ジョブのアイテム、ログ、リクエストをファイルに保存
- 04Zyte 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 とその製品(ウェブダッシュボードやアカウント/請求関連を含む)に関する一般的な使用方法、解説、またはドキュメントの質問に回答します。
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 を読んでください。
認証情報の安全性
重要:セッション中、API キーがエージェントやユーザーに表示されたり、漏えいしたりしないようにすることが不可欠です。キーの値を直接エコー、読み取り、書き込みしないでください。認証確認のために、キーまたはその値を出力する可能性のあるツール(例:cat ~/.scrapinghub.yml)を、その出力を何に渡す場合でも使用しないでください。認証情報ファイルを出力するのは決して安全ではなく、grep、sed などのフィルターを使っても安全にはなりません。
重要:Scrapy Cloud へのリクエストには、uvx shub または SKILL_DIR/scripts/ 内のスクリプトを使用してください。これらは認証情報をエージェントに漏らさずに認証を処理します。認証情報が漏えいする可能性のある curl やその他のツールを使ってリクエストしないでください。
ドキュメントと使用方法
Zyte API、Scrapy Cloud、ウェブダッシュボード、アカウント/請求、および関連ツールなど、Zyte とその製品に関する一般的な使用方法、解説、またはドキュメントの質問には、https://docs.zyte.com の公式ドキュメントを参照し、SKILLS_DIR/scrape/references/docs-access.md に従って回答してください。参照したページを明記し、ドキュメントに記載のない動作を断言しないでください。この機能に認証情報は不要です。
ウェブダッシュボード(app.zyte.com を操作して進めること)での操作を、あなた自身で実行することはできません。タスクでダッシュボードが必要な場合は、拒否するのではなく、操作方法を説明し、該当するドキュメントページへのリンクを示してください。