メインコンテンツにスキップ

Zapier連携ガイド

結論：ZapierでSurmado（スルマド）のレポートを自動化します。Surmadoの webhook_url をZapier（ザピアー）のCatch Hookトリガーに向けると、Zapierが完了ペイロード（サマリー指標は抽出済みです）を受け取り、Google Sheets / Slack（スラック） / Notion（ノーション） / メールへ転送します。さらに詳しいデータが必要な場合は、APIキーを使ってREST APIで取得します。よく使う5つのワークフローを紹介します。四半期ごとの追跡、競合アラート、Notionでの集計、Strategyの要約配信、エージェンシー向けの複数クライアントのレポート作成です。

読了時間：18分

このガイドの内容：

  • 四半期ごとの追跡の自動化を作ります。Surmadoの report.completed webhookを受け取り、report.summary.presence_score などのフィールドを読み取って、Google Sheetsに1行追加します（1ジョブあたりZapierタスク3件）
  • ポジションが弱いときの競合アラートを作ります。report.summary.competitive_rank でFilter by Zapierを使い、順位が3より大きい場合だけSlackに投稿します（発動時はタスク4件）
  • Site AuditレポートのNotionデータベース連携を設定します。report.summary.seo_score、performance_score、accessibility_score、critical_issues_count と quick_wins オブジェクトを使います（1ジョブあたりタスク4件）
  • Strategy完了の要約を経営陣に送ります。Strategyのwebhookにはサマリーが含まれませんが、report.pdf_url（30日間有効のマジックリンク）をメールにそのまま埋め込めます（1ジョブあたりタスク3件）
  • 複数クライアント向けのエージェンシー一覧表を作ります。ペイロードの report.summary.business_name をクライアントの振り分けに使い、全クライアントの指標を1つのマスターGoogle Sheetsにまとめます（クライアントのレポート1件あたりタスク3〜4件）

費用：ZapierのStarterプラン（$20/month）で、これらのワークフローを実行できます。

前提条件

必要なもの

  1. Zapierアカウント（複数ステップのZapにはStarterプラン以上が必要です）
  2. APIアクセス付きのSurmadoアカウント（PAYG、Pro（プロ）、Pro+（プロプラス）の全プランに含まれます）
  3. Surmado APIキー（sur_live_...）。app.surmado.com の Settings → API Keys で作成します
  4. 連携先アプリのアカウント（Google Sheets、Slack、Notionなど）

Zapierのプラン要件

Freeプラン：

  • 月100タスク
  • 1ステップのZapのみ
  • Surmadoのワークフローには不十分です（複数ステップが必要なため）

Starterプラン（$20/month）：

  • 月750タスク
  • 複数ステップのZap（必須）
  • 最低限のおすすめプランです

Professionalプラン（$50/month）：

  • Zapは無制限
  • Paths（条件分岐）
  • 複数のクライアントを持つエージェンシーにおすすめです

連携の基本パターン

以下の5つのワークフローは、すべて同じ流れです。

  1. トリガー：Webhooks by Zapierの「Catch Hook」。Zapierが専用のURLを発行します。
  2. Surmadoの設定：レポートを作成するときに webhook_url を含めて、完了通知をそのURLにPOSTするようにします。
  3. 解析：届いたペイロードを読み取ります。ZapierはネストされたJSONを __（アンダースコア2つ）で平らにするため、report.summary.presence_score はZapierのフィールド選択画面で report__summary__presence_score になります。
  4. （任意）REST APIで取得：サマリー以外のフィールドが必要な場合に使います。ヘッダー Authorization: Bearer sur_live_YOUR_KEY を付けて GET https://api.surmado.com/v1/reports/{{report__id}} を呼び出します。
  5. 実行：Google Sheetsへの書き込み、Slackへの投稿、Notionページの作成などを行います。

webhookペイロードの例

{
  "event": "report.completed",
  "timestamp": "2026-04-15T12:00:00+00:00",
  "report": {
    "id": "rpt_abc123xyz",
    "token": "SIG-2026-04-A1B2C",
    "product": "signal",
    "status": "completed",
    "tier": "basic",
    "data_url": "https://api.surmado.com/v1/reports/rpt_abc123xyz",
    "pdf_url": "https://api.surmado.com/v1/reports/view/VIEW_TOKEN",
    "summary": {
      "business_name": "Acme Coffee Roasters",
      "industry": "Food & Beverage",
      "brand_url": "https://acme.com",
      "presence_score": 34.2,
      "authority_score": 42.7,
      "competitive_rank": 4,
      "top_competitor": "Blue Bottle",
      "insights_summary": ["Presence score: 34.2 (↑5.5)", "..."]
    }
  }
}

Strategyレポート（"product": "solutions"）には summary オブジェクトが含まれません。代わりに report.pdf_url と report.token を使ってください。

ワークフロー1：四半期ごとの追跡をGoogle Sheetsへ

四半期ごとの追跡のユースケース

AI Visibilityのレポートが完了するたびに、サマリー指標をGoogle Sheetsに追加して、時系列で追跡します。

四半期ごとの追跡の設定

ステップ1：Google Sheetsを作成する

シート名：AI Visibility Tracking

列：

  • A: Date
  • B: Token
  • C: Business Name
  • D: Presence Score
  • E: Authority Score
  • F: Competitive Rank
  • G: Top Competitor

ステップ2：Zapを作成する。Catch Hookトリガー

トリガー：Webhooks by Zapier → Catch Hook

Zapierが https://hooks.zapier.com/hooks/catch/12345/abcdef/ のようなURLを発行します。これをコピーしてください。

ステップ3：Webhookを送るようにSurmadoを設定する

APIでAI Visibilityのレポートを作成するときに、webhook_url を含めます。

curl -X POST https://api.surmado.com/v1/reports/signal \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_slug": "acme_corp",
    "url": "https://acme.com",
    "email": "founder@acme.com",
    "industry": "B2B SaaS",
    "location": "United States",
    "persona": "Small business owners",
    "pain_points": "Losing track of customer conversations",
    "brand_details": "Simple CRM with email integration",
    "direct_competitors": "HubSpot, Pipedrive",
    "webhook_url": "https://hooks.zapier.com/hooks/catch/12345/abcdef/"
  }'

Zapierがサンプルのペイロードを取得できるように、レポートを1件実行してください。（Zapierを設定する前に、webhook.site でペイロードの形を確認しておくこともできます。）

ステップ4：Filter。完了したAI Visibilityレポートだけを処理する

アクション：Filter by Zapier

条件（すべてに一致する必要があります）：

  • event Exactly matches report.completed
  • report__product Exactly matches signal

ステップ5：Google Sheetsに追加する

アクション：Google Sheets → Create Spreadsheet Row

列のマッピング：

  • Date: {{timestamp}}
  • Token: {{report__token}}
  • Business Name: {{report__summary__business_name}}
  • Presence Score: {{report__summary__presence_score}}
  • Authority Score: {{report__summary__authority_score}}
  • Competitive Rank: {{report__summary__competitive_rank}}
  • Top Competitor: {{report__summary__top_competitor}}

ステップ6：テストして有効にする

テスト：webhook URLを指定して、実際のAI Visibilityレポートを実行します。行が追加されたことを確認してください。

有効化：Zapをオンにします。

四半期ごとの追跡ワークフローのまとめ

1. Webhooks by Zapier: Catch Hook (Surmado POSTs report.completed)
   ↓
2. Filter: event = report.completed, product = signal
   ↓
3. Google Sheets: Create row with summary metrics

1ジョブあたりのZapierタスク：3件。

ワークフロー2：競合アラートをSlackへ

競合アラートのユースケース

AI Visibilityのレポートで順位が3位より下だった場合に、Slackへアラートを投稿します。

競合アラートの設定

ステップ1〜3：ワークフロー1と同じ

（Catch Hook → レポートに webhook_url を設定 → サンプルのペイロードを取得）

ステップ4：Filter。順位が3より大きい場合だけアラートを出す

アクション：Filter by Zapier

条件（すべてに一致する必要があります）：

  • event Exactly matches report.completed
  • report__product Exactly matches signal
  • report__summary__competitive_rank (Number) Greater than 3

ステップ5：Slackにメッセージを送る

アクション：Slack → Send Channel Message

チャンネル：#marketing（またはチームのチャンネル）

メッセージ：

:warning: Competitive rank alert for *{{report__summary__business_name}}*

Ranked *#{{report__summary__competitive_rank}}* in AI visibility.

*Presence score*: {{report__summary__presence_score}}
*Authority score*: {{report__summary__authority_score}}
*Top competitor*: {{report__summary__top_competitor}}

View full report: {{report__pdf_url}}
Report token: `{{report__token}}`

競合アラートワークフローのまとめ

1. Catch Hook
   ↓
2. Filter: product = signal AND competitive_rank > 3
   ↓
3. Slack: Alert with metrics + PDF link

発動時のZapierタスク：4件（Filterも1タスクとして数えます）。

ワークフロー3：Site Audit結果をNotionデータベースへ

Site Auditのユースケース

完了したSite Auditレポートごとに、スコアと主なクイックウィンを載せたNotionデータベースのページを作成します。

Site Auditの設定

ステップ1：Notionデータベースを作成する

データベース名：Site Audit Reports

プロパティ：

  • Title (Title): [Brand] - [Date]
  • Token (Text): Intelligence Token
  • SEO Score (Number): 0-100
  • Performance Score (Number): 0-100
  • Accessibility Score (Number): 0-100
  • Total Pages (Number)
  • Critical Issues (Number)
  • Report Date (Date)
  • PDF (URL)

ステップ2〜3：Catch Hookの設定は同じ

Catch Hookを作成し、Site AuditのレポートがそのURLにPOSTするよう設定します。

curl -X POST https://api.surmado.com/v1/reports/scan \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_slug": "acme_corp",
    "url": "https://www.acme.com",
    "email": "founder@acme.com",
    "webhook_url": "https://hooks.zapier.com/hooks/catch/12345/abcdef/"
  }'

ステップ4：Filter。完了したSite Auditだけを処理する

条件：

  • event Exactly matches report.completed
  • report__product Exactly matches scan

ステップ5：Code by Zapierでクイックウィンを整形する

アクション：Code by Zapier → Run Python

Input Data：

  • quick_wins: {{report__summary__quick_wins}}（オブジェクトをJSONとして渡します）

コード：

import json

raw = input_data.get('quick_wins', '{}')
try:
    quick_wins = json.loads(raw) if isinstance(raw, str) else (raw or {})
except Exception:
    quick_wins = {}

lines = [f"- **{area.replace('_', ' ').title()}**: {text}"
         for area, text in quick_wins.items() if text]

output = {'quick_wins_md': '\n'.join(lines) if lines else 'No quick wins surfaced.'}

ステップ6：Notionページを作成する

アクション：Notion → Create Database Item

データベース：Site Audit Reports

プロパティのマッピング：

  • Title: {{report__summary__business_name}} - {{timestamp}}
  • Token: {{report__token}}
  • SEO Score: {{report__summary__seo_score}}
  • Performance Score: {{report__summary__performance_score}}
  • Accessibility Score: {{report__summary__accessibility_score}}
  • Total Pages: {{report__summary__total_pages}}
  • Critical Issues: {{report__summary__critical_issues_count}}
  • Report Date: {{timestamp}}
  • PDF: {{report__pdf_url}}

ページの内容：

## Quick Wins

{{quick_wins_md}}

## Executive Summaries

**Pages**: {{report__summary__page_analysis_summary}}

**Links**: {{report__summary__link_analysis_summary}}

**Schema**: {{report__summary__schema_strategy_summary}}

**Content gaps**: {{report__summary__content_gaps_summary}}

## Intelligence Token

`{{report__token}}`

Fetch full data: `GET https://api.surmado.com/v1/reports/{{report__id}}` with Bearer auth.

Site Auditワークフローのまとめ

1. Catch Hook
   ↓
2. Filter: product = scan
   ↓
3. Code by Zapier: Format quick_wins object into Markdown
   ↓
4. Notion: Create database page with scores + quick wins

1ジョブあたりのZapierタスク：4件。

ワークフロー4：Strategy完了の要約配信

Strategy要約配信のユースケース

Strategyのレポートが納品されたら、PDFリンクを添えたメールを経営陣に送ります。

Strategyのwebhookについて

Strategy（"product": "solutions"）のwebhookには summary オブジェクトが含まれません。Strategyレポートの構造化された出力は、現在REST APIでは公開されていないためです。受け取れるのは report.id、report.token、report.pdf_url、report.data_url です。要約にはPDFリンクを使ってください。

Strategy要約配信の設定

ステップ1〜3：Catch Hookの設定は同じ

webhook_url を付けてStrategyのレポートを作成します。

curl -X POST https://api.surmado.com/v1/reports/solutions \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "brand_slug": "acme_corp",
    "email": "founder@acme.com",
    "business_story": "B2B SaaS CRM, 50 employees, $3M ARR",
    "decision": "Should we build a mobile app or improve the web experience?",
    "success": "40% engagement increase in 6 months",
    "timeline": "Need decision in next 30 days",
    "scale_indicator": "regional",
    "webhook_url": "https://hooks.zapier.com/hooks/catch/12345/abcdef/"
  }'

ステップ4：Filter。完了したStrategyレポートだけを処理する

条件：

  • event Exactly matches report.completed
  • report__product Exactly matches solutions

ステップ5：Gmailでメールを送る

アクション：Gmail（ジーメール） → Send Email

To：leadership@yourcompany.com

Subject：Strategy report ready — token {{report__token}}

Body Type：HTML

Body：

<p>A Strategy report has been delivered.</p>

<p><strong>Token:</strong> <code>{{report__token}}</code></p>

<p><a href="{{report__pdf_url}}">View the full report (PDF)</a></p>

<p><small>The PDF link is a magic-link URL valid for approximately 30 days.
For programmatic access to the report metadata, call
<code>GET https://api.surmado.com/v1/reports/{{report__id}}</code>
with your Surmado API key.</small></p>

Strategy要約配信ワークフローのまとめ

1. Catch Hook
   ↓
2. Filter: product = solutions
   ↓
3. Gmail: Send PDF link to leadership

1ジョブあたりのZapierタスク：3件。

ワークフロー5：複数クライアント向けエージェンシー一覧表

エージェンシー一覧表のユースケース

20社のクライアントに毎月AI Visibilityを提供しているエージェンシーを想定します。全クライアントの指標を、マスターのGoogle Sheetsに自動で集めます。

エージェンシー一覧表の設定

ステップ1：マスターシートを作成する

シート名：Client Dashboard

列：

  • A: Client Name
  • B: Date
  • C: Token
  • D: Presence Score
  • E: Authority Score
  • F: Competitive Rank
  • G: Top Competitor
  • H: Status

ステップ2：全クライアントで1つのCatch Hookを使う

Catch HookのZapを1つだけ作成します。すべてのクライアントのレポートで、同じ webhook_url を使います。ペイロードには（登録したブランドから取得した）report.summary.business_name が含まれるため、Zapierは同じZapの中でクライアントごとに振り分けられます。

各クライアントを、最初に1回だけ別々のブランドとして作成します。

curl -X POST https://api.surmado.com/v1/brands/ensure \
  -H "Authorization: Bearer sur_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand_name": "Phoenix Cool Air"}'

その後、レポートを作成するときに、返ってきた brand_slug を再利用します。

ステップ3：report.completed と signal でFilterする

（ワークフロー1と同じです。）

ステップ4：Formatterでステータスを算出する

アクション：Formatter by Zapier → Numbers → Lookup Table

入力：{{report__summary__presence_score}}

Lookup：

  • 0 to 30: At Risk
  • 30.01 to 60: Needs Work
  • 60.01 to 100: Leading

出力：ステータスのテキスト。

ステップ5：マスターシートに追加する

アクション：Google Sheets → Create Spreadsheet Row

列のマッピング：

  • Client Name: {{report__summary__business_name}}
  • Date: {{timestamp}}
  • Token: {{report__token}}
  • Presence Score: {{report__summary__presence_score}}
  • Authority Score: {{report__summary__authority_score}}
  • Competitive Rank: {{report__summary__competitive_rank}}
  • Top Competitor: {{report__summary__top_competitor}}
  • Status: （ステップ4の結果）

ステップ6：リスクのあるクライアントへの条件付きSlackアラート

アクション：Filter by Zapier

条件：report__summary__presence_score (Number) Less than 30

アクション：Slack → Send Channel Message

メッセージ：

:rotating_light: At-risk client alert: *{{report__summary__business_name}}*

*Presence score*: {{report__summary__presence_score}} (below 30 threshold)
*Competitive rank*: #{{report__summary__competitive_rank}}

Action needed: Schedule a Strategy report or content optimization sprint.

View AI Visibility report: {{report__pdf_url}}

エージェンシー一覧表ワークフローのまとめ

1. Catch Hook (single URL, used by all client reports)
   ↓
2. Filter: product = signal
   ↓
3. Formatter: Classify status from presence score
   ↓
4. Google Sheets: Add row with client metrics
   ↓
5. [If presence_score < 30] Slack: at-risk alert

クライアントのレポート1件あたりのZapierタスク：3〜4件。20社なら月におよそ70〜90タスクで、Starterプランの範囲に十分収まります。

応用パターン

パターン1：REST APIでさらに詳しいデータを取得する

webhookのサマリーでほとんどの用途はまかなえます。ただし、プラットフォーム別の内訳（たとえばChatGPTとClaudeのPresence Score）が必要な場合は、public_intelligence オブジェクト全体を取得します。

アクション：Webhooks by Zapier → GET

URL：https://api.surmado.com/v1/reports/{{report__id}}

ヘッダー：

  • Authorization: Bearer sur_live_YOUR_API_KEY

レスポンスの形（AI Visibility）：

{
  "report_id": "rpt_abc123xyz",
  "status": "completed",
  "token": "SIG-2026-04-A1B2C",
  "public_intelligence": {
    "summary": { "presence_score": 34.2, "...": "..." },
    "data": {
      "visibility_metrics": { "presence_score": 34.2, "ghost_influence_percentage": 48.3 },
      "platform_variance": { "chatgpt": { "presence_score": 42.1 }, "claude": { "..." } },
      "competitive_position": { "rank": 4, "total_competitors": 12 },
      "...": "..."
    }
  }
}

Zapierでは、これらは public_intelligence__data__platform_variance__chatgpt__presence_score のように平らになります。

スキーマの全体は 構造化データとIntelligence Token をご覧ください。

パターン2：過去との比較

ユースケース：新しいレポートを、前の四半期のレポートと比較します。

設定：

  1. Catch Hookを作成し、signal に絞り込みます
  2. Google Sheets → Lookup Spreadsheet Row（このブランドの前回のトークンを探します）
  3. Webhooks by Zapier → GET（前回のレポートのRESTエンドポイントを呼び出します）
  4. Code by Zapier → 差分を計算します（今回 - 前回）
  5. 比較結果をシートに追記するか、メールで送ります

パターン3：複数の送信先への同時配信

ユースケース：同じデータをGoogle Sheets、Notion、Airtableに送ります。

設定：Catch Hookを1つ作り、Filterを通したあと、送信先ごとに「行・ページ・レコードを作成する」アクションを並列で追加します。1つのwebhookペイロードが、すべての送信先に届きます。

パターン4：Webhook署名の検証（任意）

Surmadoはすべてのwebhookに X-Surmado-Signature（正規化したJSON本文に対するHMAC-SHA256）で署名します。重要度の高いワークフローでは、処理の前にCode by Zapierのステップで署名を検証してください。検証アルゴリズムは API連携ガイド をご覧ください。

トラブルシューティング

問題1：Catch Hookが動作しない

症状：Surmadoのレポートが完了しても、Zapが反応しません。

原因：

  • レポート作成の呼び出しに webhook_url を含めていませんでした
  • ZapierのURLがHTTPSではありません（SurmadoはHTTPSを必須としています。ZapierのURLは常にHTTPSですが、入力ミスがないか確認してください）
  • Zapがオフになっています
  • レポート自体が失敗しました（代わりに report.failed イベントを確認してください）

対処：

  • webhook.site をテスト用のURLに使い、Surmadoがペイロードを送っているか確認します
  • GET /v1/reports/{report_id} でレポートのステータスを確認します。failed の場合、届くのは completed ではなく report.failed のwebhookです
  • Zapをオンにして、テスト用のレポートを実行します

問題2：Google SheetsやNotionでフィールドが空になる

症状：送信先の行に空白のセルがあります。

原因：

  • フィールドのパスで、アンダースコアが2つではなく1つになっています（report__summary__presence_score ではなく report_summary_presence_score）
  • そのプロダクトにフィールドがありません（たとえば、Site Auditのレポートには presence_score がなく、Strategyにはサマリーのフィールドが一切ありません）
  • 元のIntelligenceにそのフィールドの値が入っていません（たとえば、ブランドに競合が特定されていない場合、top_competitor はnullになることがあります）

対処：

  • パスを手で入力せず、Zapierのフィールド選択画面を使います
  • プロダクトを確認します。report__product で、どのサマリーフィールドが届くかが分かります
  • AI Visibilityのサマリーフィールドは抽出処理から生成されます。フィールドの一覧は 構造化データとIntelligence Token をご覧ください

問題3：REST APIの取得が401 Unauthorizedになる

症状：Webhooks by ZapierのGETステップが401で失敗します。

原因：Authorization ヘッダーがないか、形式が正しくありません。

対処：ヘッダーが Authorization: Bearer sur_live_...（Bearer の接頭辞を含む）になっているか確認してください。代わりに X-API-Key: sur_live_... を使うこともできます。

問題4：Google Sheetsに行が重複する

症状：同じレポートが2回表示されます。

原因：

  • Surmadoは配信に失敗したwebhookを再試行します（バックオフを置いて3回）。Zapの処理が遅いと、Zapierが受信を確認する前にSurmadoが再試行することがあります
  • 同じブランドの2つのレポートに webhook_url を設定しました

対処：

  • すばやく応答します。ZapierのCatch Hookは標準で高速ですが、負荷の高いFilterやCodeのステップがあると、Surmadoの30秒のタイムアウトを超えて応答が遅れることがあります
  • report__id で重複を除きます（ZapierのFormatterやGoogle Sheetsのルックアップで、挿入前に既存の行を確認できます）

問題5：Presence Scoreが0〜100ではなく0〜1になる

症状：Presence Scoreが 34.2 ではなく 0.342 と表示されます。

原因：古いフィールドパスを参照しています（元になっている visibility_metrics.presence_rate の旧形式です）。サマリーのフィールド report.summary.presence_score は、すでに0〜100に正規化されています。

対処：report__summary__presence_score をそのまま使ってください。掛け算は不要です。

ベストプラクティス

1. Zapの名前を統一する

  • AI Visibility → Google Sheets (Client Dashboard)
  • Site Audit → Notion Database
  • Strategy → Email Leadership

理由：Zapが50件以上になっても、Zapierの管理画面で見分けやすくなります。

2. エラー通知を追加する

重要なZapの最後にステップを追加し、前のステップが失敗したときにメールまたはSlackで知らせるようにします。Zapierの標準のエラー通知は、初期状態では通知されません。

3. フォルダで整理する

Zapierのフォルダ（Professionalプラン）：

  • Client Reporting：クライアント向けの集計用Zapすべて
  • Internal Monitoring：自社のレポート
  • Alerts：競合アラート、リスクのあるクライアント

4. プロダクトごとにCatch Hookを1つ

ブランドごとではなく、プロダクト（AI Visibility / Site Audit / Strategy）ごとにCatch HookのZapを1つ運用します。Zapの中で report__product を使ってFilterしてください。webhook_url は、ブランドまたはレポートを作成するときに1回設定するだけです。

5. 再処理のために生のペイロードを保存する

webhookのペイロード全体を、「raw events」用のシートまたはデータベースに記録します。あとで下流の処理を変えても、レポートを再実行せずに過去のイベントを再処理できます。

Zapierタスク数の見積もり

レポート1件のワークフロー：

  • 追跡（Catch Hook → Filter → Sheets）：3タスク
  • Slackアラート付き：4タスク
  • NotionとCodeステップ：4タスク
  • 条件付きアラートを含むエージェンシー向けの全ワークフロー：5〜6タスク

エージェンシー向けの集計（月20社）：

  • 基本の追跡：月およそ60〜80タスク
  • アラートと複数の送信先あり：月およそ100〜140タスク

おすすめのプラン：

  • クライアント1〜5社：Starter（$20/month、750タスク）
  • クライアント5〜20社：ほとんどの場合Starterで足ります。Professional（$50/month）では、PathsとFoldersが加わります
  • クライアント20社以上：フォルダとフィルターを使うProfessional

よくある質問

webhookを設定せずにZapを起動できますか？

はい。代替手段として、Gmailで hi@surmado.com からのメールをトリガーにできます（Surmadoはレポートの完了時にメールでも通知します）。ただし、webhookのほうが速く、確実で、サマリーのペイロード全体を受け取れます。webhookをおすすめします。

ZapierとSurmadoの両方に料金を払う必要がありますか？

はい。Zapierは別の自動化プラットフォームです。Surmadoはレポート、REST API、webhookの配信を提供し、Zapierがその2つをつなぎます。

Zapをクライアントと共有できますか？

はい（Professionalプラン）。Zapier Transferを使うと、ZapをクライアントのZapierアカウントにコピーできます。クライアントは必要に応じてカスタマイズできます。

サマリーのフィールドが変わったらどうなりますか？

Intelligence Tokenの形式（SIG-、SCN-、SOL-）は安定しています。サマリーのフィールド名は今後増えることがありますが、既存のフィールドを削除したり名前を変えたりしない方針です。互換性を損なう変更がある場合は、API利用者にお知らせします。

Zapierで過去データの一括分析はできますか？

一部できます。更新したいブランドのレポートは、手動で再実行できます。過去の多数のレポートをまとめて分析する場合は、REST APIを直接使ってください（GET /v1/reports はページ分割されています）。API連携ガイド をご覧ください。

ZapierはSite Auditのコンテンツギャップに使えますか？

はい。Site Auditのペイロードには、エグゼクティブサマリーの文字列として report.summary.content_gaps_summary が、優先度付きの提案として report.summary.quick_wins.content_gaps が含まれます。ギャップの全一覧が必要な場合は、REST APIを呼び出して public_intelligence.data.audit_data.enrichment.content_gaps を読み取ってください。

ZapierはStrategyレポートに使えますか？

一部使えます。Strategyのwebhookが運ぶのはトークンとPDFリンクで、構造化されたサマリーではありません。完了をきっかけにする処理（PDFを送る、タスクを作る、経営陣に知らせる）に使ってください。Strategyの構造化データは、現在REST APIでは公開されていません。今後の予定は、ロードマップ次第です。

Zapierの連携設定でお困りですか？ ご利用の用途を添えて hi@surmado.com までご連絡ください。カスタムのZapテンプレートや連携のサポートをご提供できます。

これらの関連ガイドで学習を続けてください

技術的 SEO

Structured Data & Intelligence Tokens

Every Surmado report includes structured JSON for programmatic access. Learn how to integrate AI Visibility, Site Audit, and Strategy data into your tools, dashboards, and automation workflows.

記事を読む
技術的 SEO

Surmado API Integration Guide

Everything an external developer needs to create an API key, generate reports, and plug Surmado into automated workflows.

記事を読む
技術的 SEO

The llms.txt Standard: A Complete Technical Guide for Developers

Learn how to implement llms.txt to help AI platforms discover and cite your business. Technical implementation guide with code examples, best practices, and testing strategies.

記事を読む