Agent First アーキテクチャ: Agents、Skills、MCP、APIs

Agent First アーキテクチャ: Agents、Skills、MCP、APIs
Unif Agents team
Unif Agents team

UnifAPI がマーケティング Agents を最優先にし、Skills をワークフローとして読み込み、SEO・GEO・ブラウザ・ソーシャル API を根拠レイヤーに置く理由。

要点: UnifAPI は今、マーケターが Claude、Codex、あるいは別の MCP 対応アシスタントに任せたい仕事から始まります。Agents が製品サーフェスであり、Skills が実行可能なランブック、MCP が接続経路、APIs がライブの公開データ根拠レイヤーです。

UnifAPI の最初のバージョンは、開発者に説明するのが簡単でした。1 つの API キー、1 つの OpenAPI 契約、たくさんの公開データエンドポイント。それは今も真実ですが、アシスタントにマーケティングリサーチをさせたい運用者にとって、最も役立つ最初の一文ではなくなりました。

運用者は「SEO エンドポイントファミリー」や「レンダリングされた Browser Markdown 呼び出し」を求めたりはしません。彼らが求めるのは、順位監査、GEO ビジビリティレポート、クリエイターのショートリスト、競合ブリーフ、ローカルパックスキャン、コンテンツ機会のメモです。Agent First アーキテクチャはそこから始まります。

4 つのレイヤー

レイヤー意味例
Agentアシスタントの中で実行する、名前の付いたマーケティングの役割SEO Agent、AI Visibility Agent、Competitive Intelligence Agent
SkillSKILL.md ランブックとして実装された単一の能力seo-audit、ai-answer-gap、competitor-profiling
MCPアシスタントが UnifAPI を呼び出せるようにする接続経路list_operations、get_operation、call_api
APIワークフローの背後にあるライブの公開データ契約/seo/serp、/geo/serp、/browser/markdown

このスタックが重要なのは、各レイヤーに異なる仕事があるからです。Agent は成果に名前を付けます。Skill はアシスタントに作業のやり方を伝えます。MCP は認証・発見・呼び出しを担います。API は引用できるレコードを返します。

この分離が製品を正直に保ちます。Skill が AI ビジビリティをチェックできると言うなら、GEO API は回答・引用・メンション・ボリュームのレコードを返さなければなりません。SEO Agent がページを検査できると言うなら、Browser API は URL 文字列だけでなく、レンダリングされた Markdown や HTML を返さなければなりません。

なぜ Agents が最前面なのか

UnifAPI Agents はホスト型のボットではありません。あなたは Claude や Codex など、すでに使っているアシスタントの中でそれらを実行します。UnifAPI は MCP を通じて、役割、Skills、公開データを供給します。

この言い回しは意図的です。ランタイムはあなたのアシスタントです。UnifAPI Agent は役割特化のワークフローパッケージです。データレイヤーは UnifAPI です。

これにより、運用者はシンプルなメンタルモデルを得ます。

  1. 仕事に合った Agent を選ぶ。
  2. UnifAPI MCP を一度接続する。
  3. Agent のプロンプトを貼り付ける、またはロードする。
  4. アシスタントに必要な公開データの根拠を取得させる。
  5. 引用付きのブリーフを確認し、次に何をするか決める。

同じスタックは開発者にも役立ちます。開発者は散文的なワークフローを飛ばして HTTP API を直接呼び出せますが、公開のマーケティングサーフェスは、開発者でない人すべてに最初から API カタログを学ばせるべきではありません。

Skills で何が変わったか

Skills はもはや、ブログのトピックやサンプルにとどまりません。Agent を再現可能にする実装の成果物です。

良い Skill は 1 つの具体的な能力に名前を付けます。SEO を監査する、LLM メンションを追跡する、LinkedIn アカウントをリサーチする、クリエイターのショートリストを作る、ローカル競合をスキャンする、競合をプロファイリングする。トリガーフレーズ、入力チェックリスト、使うべき公開データの呼び出し、出力の形、確信度のルール、境界を含めるべきです。

だからこそ Skill はプロンプトの断片よりも役立ちます。プロンプトは成果を求めることができます。Skill はワークフロー、データソースの選択、そして期待される根拠の基準をコード化できます。

なぜ API カタログは今も重要なのか

API カタログは今もライブデータの真実の源です。SEO、GEO、Browser、ローカル、ソーシャル、ニュース、トラベル、イベントのすべてが、統一された契約を通じてエンドポイントを公開しています。

違いは、運用者がどこから入るかです。

ユーザーの意図最適な入口
「これらのキーワードの順位を監査して」SEO Agent
「ChatGPT が私たちを引用するか追跡して」AI Visibility Agent
「この JavaScript 中心のページを読んで」Browser API または SEO Skill
「クリエイターのショートリストを作って」Influencer Marketing Agent
「自分のアプリに公開データを統合したい」HTTP API ドキュメント

このアーキテクチャは、製品を巨大なエンドポイントのメニューに変えることなく、UnifAPI がより多くの APIs を追加することを可能にします。新しい API のカバレッジは、Skill と Agent の成果に組み込まれたときに、より役立つものになります。

読み取り専用の境界

現在の製品は「目であって、手ではない」です。UnifAPI は公開データを読みます。投稿したり、公開したり、リスティングを編集したり、広告を買ったり、リードにメッセージを送ったり、上流の投稿用認証情報を保持したりはしません。

それでも Agent はアクションのステップを推奨できます。SEO Agent はどのページを改善すべきかを言えます。AI Visibility Agent はどの情報源が引用カバレッジを改善する必要があるかを説明できます。Social Selling Agent はアプローチの切り口を下書きできます。それらのアクションを実行するのは、運用者とその人自身のツールです。

その境界は良い製品の規律です。認証をシンプルに保ち、ユーザーを誤った書き込みアクションから守り、すべての出力をレビュー可能にします。

サンプル実行

SEO Agent にドメインとキーワードセットを与えます。アシスタントは SEO Skills をロードし、UnifAPI MCP を通じて接続し、ライブの SEO レコードを呼び出し、レンダリングされたページ検査に Browser Markdown を使い、次を返します。

セクション根拠
順位サマリークエリごとのオーガニックおよび AI SERP の順位
ビジビリティギャップ競合がランクインしている、または引用されているクエリ
ページ診断レンダリングされたページの見出し、リンク、コンテンツブロック
修正プランアクションではなく推奨としてラベル付けされた、優先順位付き変更
ソースログ呼び出した操作、使ったレコード、確信度の注記

運用者は、最初の有用な回答を得る前にエンドポイントツリーを知る必要はありません。しかし、トレーサビリティと本番利用のために、エンドポイントツリーは今もそこにあります。

主要な参考資料

本記事のアーキテクチャの枠組みは、公式の Model Context Protocol アーキテクチャ概要 と整合し続けるべきです。MCP はホスト、クライアント、サーバーのモデルを記述し、ツール、リソース、プロンプトといったプリミティブを備えています。UnifAPI の製品言語は、それらのプリミティブを上記の運用者向けレイヤーにマッピングします。

コンテンツとエンティティのマークアップについて、生成されたブログページは schema 互換の記事メタデータを使います。Schema.org Article と Schema.org BlogPosting の公開ボキャブラリと比較してください。検索向けのページの基本については、Google の SEO スターターガイド と実装を整合させ続けましょう。

次に読むべきもの

SEO Agent によるライブ順位監査 - クラシックな順位トラッキングの役割エージェント版です。

GEO のための AI Visibility Agent - GEO レコードがどう回答エンジンのビジビリティ作業を支えるか。

エージェントの Web 読み取りのための Browser API - レンダリングされたページがマーケティング Agents の補助的な能力である理由。