sitespeakai-automation

sitespeakai-automation skill の概要

sitespeakai-automation でできること

sitespeakai-automation は、Composio の Rube MCP server を通じて Sitespeakai の操作を実行するための Claude skill です。API フィールドを推測したり、古くなったワークフローをハードコードしたりするのではなく、まず RUBE_SEARCH_TOOLS で現在の Sitespeakai tool schema を確認し、Sitespeakai 接続を検証したうえで、適切な Rube tool を実行することを中核の手順にしています。

Sitespeakai の各操作を手動でたどる代わりに、会話型ワークフローの中で AI agent に Sitespeakai 運用を手伝わせたい場合に使います。

向いているユーザーと用途

sitespeakai-automation skill が特に役立つのは、すでに Sitespeakai を使っていて、Rube MCP 経由で接続する準備があるチームです。利用できる Sitespeakai action の確認、自動化リクエストの準備、実行前の必須フィールド検証、Composio の toolkit レイヤーを介した認証済みタスクの実行といったワークフローに向いています。

これは単体の Sitespeakai SDK、スクレイパー、あるいは Sitespeakai のプロダクト知識を置き換えるものではありません。価値の中心はオーケストレーションです。つまり、agent が tool を発見し、最新の schema に従い、思い込みで実行してしまうことを避けるための skill です。

主な差別化点: schema-first automation

最も重要な設計思想は「まず tool を検索する」ことです。Rube tool schema は変わる可能性があり、Sitespeakai action には一般的なプロンプトからは分かりにくいフィールドが必要な場合があります。実行前に RUBE_SEARCH_TOOLS を必須にすることで、sitespeakai-automation は古いパラメータ、不足している識別子、誤った tool 名による失敗を減らします。

導入前に確認すべき要件

インストール前に、利用する AI client が MCP をサポートしていること、Rube MCP を server として追加できること、そして RUBE_MANAGE_CONNECTIONS を通じて Sitespeakai 接続を認可できることを確認してください。利用環境で MCP tools を使えない場合、この skill は実行可能な自動化レイヤーというより、手順書に近い働きになります。

sitespeakai-automation skill の使い方

sitespeakai-automation のインストール前提

利用している client が Claude skills に対応している場合は、Composio skills repository から skill をインストールします。

npx skills add ComposioHQ/awesome-claude-skills --skill sitespeakai-automation

次に、client configuration に Rube MCP を server として追加します。

https://rube.app/mcp

上流の skill では、MCP endpoint 用の別 API key は不要とされています。ただし、有効な Sitespeakai connection は必要です。実運用では、まず RUBE_SEARCH_TOOLS が利用可能か確認し、その後 toolkit に sitespeakai を指定して RUBE_MANAGE_CONNECTIONS を使い、返された認可フローがあれば完了してください。

skill に渡すべき入力

弱いプロンプトの例は次のようなものです。

“Automate Sitespeakai.”

より良いプロンプトでは、agent が適切な tool を検索し、曖昧な実行を避けられるだけの文脈を与えます。

Use sitespeakai-automation for Workflow Automation. First search Rube tools for the current Sitespeakai schema. I want to [specific task]. My target site/project is [name or ID if known]. Before executing, tell me which Sitespeakai tool you plan to call, what required fields are missing, and whether my Sitespeakai connection is active.

役立つ入力には、変更・操作したい Sitespeakai object の正確な情報、既知の ID、期待する結果、agent に実行まで任せるのか計画作成だけにするのか、そして「確認なしに公開しない」のような安全上の制約が含まれます。

実務での sitespeakai-automation 利用フロー

いきなり実行するのではなく、まず発見から始めます。

1. 対象の Sitespeakai タスクについて、agent に RUBE_SEARCH_TOOLS を呼び出させる。
2. 返された tool slugs、必須フィールド、schemas、既知の注意点を確認させる。
3. RUBE_MANAGE_CONNECTIONS で Sitespeakai connection を確認する。
4. 非アクティブな場合は auth link を完了し、ステータスを再確認する。
5. 実行前に、予定している call の内容を agent に要約させる。
6. 必須フィールドがそろい、action が明確になってから実行する。

この手順が重要なのは、skill repository に含まれているのが SKILL.md のみだからです。helper scripts、reference examples、local validation utilities はありません。信頼すべき情報源は、実行時に取得する Rube schema です。

最初に読むべき repository files

まず composio-skills/sitespeakai-automation/SKILL.md を読んでください。そこには前提条件、MCP endpoint、connection flow、必須の discovery pattern が記載されています。現在の skill path には追加の README.md、rules/、resources/、scripts/ フォルダーはないため、隠れた実装ファイルを探すのに時間を使う必要はありません。

toolkit の挙動をより深く確認したい場合は、リンクされている Composio toolkit documentation を参照してください: https://composio.dev/toolkits/sitespeakai.

sitespeakai-automation skill FAQ

Rube MCP なしで sitespeakai-automation は使えますか？

いいえ。この skill は Rube MCP tools、特に RUBE_SEARCH_TOOLS と RUBE_MANAGE_CONNECTIONS に依存しています。MCP にアクセスできない場合でも、モデルにワークフローの型を思い出させることはできますが、schema の確実な発見、connection state の確認、Sitespeakai action の実行はできません。

通常のプロンプトより何が優れていますか？

通常のプロンプトでは、Sitespeakai のパラメータを作り上げてしまったり、認証チェックを飛ばしたりする可能性があります。sitespeakai-automation skill は、agent に対して、まず現在の Composio tool schema を発見し、Sitespeakai connection を確認し、Rube が返す execution plan を使うよう明示します。フィールド名や tool の利用可否が重要な運用タスクでは、この手順のほうが安全です。

初心者にも向いていますか？

はい。AI client で MCP を設定でき、authorization link に従えるなら初心者にも使えます。skill のワークフロー自体はシンプルですが、MCP setup が主なハードルです。初心者は、まず read-only や計画作成のプロンプトから始め、提案される各 tool call を agent に説明させ、破壊的な action をすぐに実行しないようにしてください。

この skill を使わないほうがよい場面は？

オフライン処理、Sitespeakai API を直接使った開発、独自の retry logic が必要な bulk jobs、または組織が Rube 経由で認可していない action が必要な場合は、sitespeakai-automation を使うべきではありません。また、agent が正しい Sitespeakai target を特定できるだけの文脈を提供できない場合も避けてください。

sitespeakai-automation skill の改善方法

制約を入れて sitespeakai-automation プロンプトを改善する

良いプロンプトほど、安全な call につながります。ビジネス上の目的、target object、許可する action、確認ルール、出力形式を含めてください。例:

Search Sitespeakai tools first. I need to update the configuration for [project/site]. Do not execute until you list the selected tool, required fields, missing values, and any irreversible effects. If multiple tools match, compare them before choosing.

これにより、agent に早まった実行を促すのではなく、skill に判断の境界線を与えられます。

防ぐべきよくある失敗

よくある失敗は、Sitespeakai connection が非アクティブなままになっていること、schema discovery を省略すること、タスク説明が曖昧なこと、object ID が不足していること、記憶だけで tool 名を想定することです。agent が RUBE_SEARCH_TOOLS を呼び出す前に実行しようとしたら、止めて手順を戻してください。call が失敗した場合は、試したパラメータを最新の returned schema と照合するよう依頼します。

最初の出力後に反復する

最初の plan や tool result が出たら、簡潔な監査を依頼します。何を発見したのか、何を実行したのか、何が変わったのか、何がまだ不確かなのかを確認してください。複数ステップの workflow automation では、可能であれば同じ Rube session を維持し、discovery context を引き継ぎます。タスク内容が変わった場合は、新しいユースケースで改めて tool search を実行してください。

skill をさらに強くするには

この repository は、具体的な Sitespeakai タスク例、よくある操作向けの sample prompts、read-only と write-action の使い分けガイド、connection failures の troubleshooting notes があると、さらに有用になります。それらが用意されるまでは、ユーザーは live Rube discovery を信頼し、実行前に agent が選択した tool schema を提示するよう必ず求めるべきです。