← Back to News
Claude Code

Spotify Engineering: Claude Code Pluginで自然言語Spotify Ads APIインターフェースを構築 — Markdown-onlyプラグインアーキテクチャの本番リファレンス

元記事を読む →

Summary

Spotify Engineeringが5月にClaude Code用Ads APIプラグインの技術ブログを公開し、同時にGitHub(spotify/ads-agentic-tools)でApache 2.0ライセンスのオープンソースとしてリリース(v1.4.0、5月20日)。Spotify Ads API v3の30以上のリソースタイプ・ネスト化されたターゲティング構造・マルチステップエンティティ階層を、自然言語で操作可能にするClaude Code/Codexプラグイン。技術的に注目すべきは、プラグイン全体がMarkdownファイル・Bashスクリプト・2つのPythonヘルパーのみで構成され、OpenAPI仕様(約8,600行)をソースオブトゥルースとして活用、OpenAPI Linksでエンティティ間の関係をエンコードする設計。Skills・Agents・Hooksの三層構成で、キャンペーン管理・レポーティング・アセットアップロード・バルクオペレーション・モニタリングの各ワークフローを実装。コンパイル不要のMarkdown-onlyプラグインアーキテクチャが複雑なAPIの本番統合で機能することを実証。

Key Takeaways

  • Markdown + OpenAPI specのみで複雑なAPI(30+リソースタイプ)の自然言語インターフェースを実現
  • コンパイル不要 — Skills・Agents・Hooksのマークダウン定義のみで本番品質のプラグインを構築
  • OpenAPI Links活用でエンティティ関係をプラグインに組み込む設計パターン
  • Apache 2.0でオープンソース公開 — Claude Codeプラグイン開発の参照実装
  • Codexプラグインとしても動作するクロスプラットフォーム設計

Best Practice Updates

  • Claude Codeプラグイン開発ではMarkdown-only + OpenAPI specアーキテクチャがSpotifyの本番事例で実証 — 複雑なAPIでもコンパイル不要のプラグイン構築が可能

元記事の著作権は各著作者に帰属します。