SALES MARKER ／ CLIENT CONSULTING

Superset連携データの MCP化 項目定義

SIG-667〜670 の要件です。いま Superset から手動でCSVエクスポートして使っているデータを、MCP経由で直接取得できるようにしたい、というのが依頼の中身です。以下は「どの画面のどのデータか」を、実際のエクスポート列名で特定したものです。

株式会社Sales Marker ／ CS ／ 作成 2026-07-30
English version ↗

何に使うかこの2つの用途が、項目の必須／任意を決めています

レポート

顧客ごとの活動レポートの自動生成

ISCが顧客に出す月次レポートを、Supersetからの手動CSVエクスポートではなくMCP経由で自動生成したい。いま出しているのは 架電数・担当者会話率・アポ率・アポ獲得企業数・不在/受付止まりの内訳・月次/週次推移・リスト別・業種/規模別。

予兆検知

ヘルススコアによる解約予兆の検知

アプローチが止まっている・検知した企業に手が付いていない・連携が切れている・ログインが減っている、を横断で検知したい。契約単位のスコアにして、更新月の近い顧客から手を打つ。

いちばん大事な設計意図検知とアプローチが突合できないと、どちらのデータも価値が半分になります

インテント検知KW・ビジター・ドメインで
どの企業が動いたか
→
アプローチその企業に
実際に手を打てたか
→
結果会話・アポに
つながったか
→
ヘルススコア運用が回っているか
解約予兆はないか
そのため、両方のデータに「ターゲット企業法人ID」を必ず含めてください

現行の Keyword Hit のエクスポートは企業名しか持っておらず、社名の名寄せが必要になっています。法人IDがあれば、検知した企業のうち何社に手が付いたかが、そのまま出せます。

確認への回答いただいた認識合わせへの回答です

アプローチ実績いただいた認識: 各チャネルの送信実績数
それだけでは足りません。「送信したか」に加えて「何が起きたか（フェーズ名）」と「企業単位のユニーク数」が要ります。会話率もアポ率も、送信数だけでは分子が作れないためです。
インテント検知実績（KW・ビジター・ドメイン）いただいた認識: ヒット数と該当企業
その認識で合っています。数だけでは運用改善に使えないため、企業は必ずセットでお願いします。さらに、突合のために検知企業の法人IDを追加してほしいです（現行CSVは社名のみ）。
システム連携状況いただいた認識: SF連携やその他
有無に加えて、最終同期日時と直近のエラーが欲しいです。「設定はあるが止まっている」を解約予兆として拾いたいためです。
ユーザーのログイン状況いただいた認識: ユーザーのログイン履歴
履歴に加えて、Subs単位の集計（発行ID数に対する稼働ID数、WAU/MAU）があると、そのままヘルススコアに使えます。

対象チケットどのチケットがどのデータに対応するか

Linear対象
SIG-667アプローチ実績
SIG-668インテント検知実績
SIG-669システム連携状況
SIG-670ユーザーのログイン状況

項目定義項目名は Superset のエクスポート列そのままです。必須＝現行の運用で実際に使っていて、無いとレポート指標が作れないもの

薄く色の付いた行は、現行のエクスポートには無く、追加をお願いしたい項目です。

アプローチ実績（活動明細）

1行 ＝ 1活動 全 26 項目 ／ うち必須 24

Superset「活動一覧」相当。架電・送信の1件ごとに、その結果（フェーズ）まで持つ。

項目名（Superset表記）フィールド名案型 必須度用途・これで出す指標備考
subscription_namestring必須顧客の特定
target_company_namestring必須アプローチ先の特定
target_company_idstring必須インテント検知データとの突合キー最重要。これが無いと検知→アプローチの歩留まりが出せない
industry_majorstring必須業種別のアポ率比較
industry_minorstring必須業種別の深掘り
employee_countnumber必須規模別の深掘り
employee_rangestring必須規模別のアポ率比較
revenue_rangestring必須規模別の深掘り
capitalnumber任意—
capital_rangestring任意—
prefecturestring必須地域別の実績
channelstring必須チャネル別実績。架電数の母数コール/メール/フォーム/広告/SNS/手紙
phase_namestring必須会話率・不在率・受付止まり率「送信したか」ではなく「何が起きたか」。これが要の項目
phase_categorystring必須フェーズの集約表示
phase_category_normalizedstring必須表記ゆれ吸収後の集計
has_departmentboolean必須担当者名の有無による架電結果の差
contact_reachedboolean必須担当者接触率（公式フラグ）
activity_datedate必須月次・週次の推移
has_signal_30dboolean必須シグナル有無別のアポ率比較インテント運用の効果検証に使用
has_keyword_signal_30dboolean必須シグナル種別ごとの効果検証
has_visitor_intent_30dboolean必須シグナル種別ごとの効果検証
has_domain_intent_30dboolean必須シグナル種別ごとの効果検証案件一覧には「ドメインインテントあり」があるが活動一覧には無い。揃えてほしい
has_appointmentboolean必須アポ率・アポ獲得企業数
approacherstring必須担当者別の実績
productstring必須商材別のフィルタ複数商材を運用する顧客で必須
call_list_namestring必須リスト別の実績

アプローチ実績（企業単位）

1行 ＝ 1ターゲット企業 全 44 項目 ／ うち必須 38

Superset「案件一覧」相当。企業ごとの到達チャネルと最新ステータスを持つ。

項目名（Superset表記）フィールド名案型 必須度用途・これで出す指標備考
subscription_idstring必須顧客の特定・他データとの突合キー
subscription_namestring必須顧客の特定
isc_ownerstring必須担当者別の管理
target_company_idstring必須活動データ・検知データとの突合キー
target_company_namestring必須アプローチ先の特定
industry_majorstring必須業種別の分布
industry_minorstring必須業種別の深掘り
employee_countnumber必須規模別の深掘り
employee_rangestring必須規模別の分布
revenue_rangestring必須規模別の深掘り
capitalnumber任意—
capital_rangestring任意—
first_activity_datedate必須初回接触からの経過日数
last_activity_datedate必須放置企業の検出
channelsstring必須マルチチャネル運用の実施状況複数チャネルの併用有無
approach_categorystring必須アプローチ済み/未の切り分け
latest_statusstring必須ネクストアクション別の残件数
has_signal_30dboolean必須検知済み企業へのアプローチ充足率
has_keyword_signalboolean必須シグナル種別ごとの充足率
has_visitor_intent_30dboolean必須シグナル種別ごとの充足率
has_domain_intentboolean必須シグナル種別ごとの充足率
keywords_7dstring[]任意—直近30日があれば足りる
keywords_30dstring[]必須どのKWで検知したかKW別の成果分析に使用
keywords_90dstring[]任意—直近30日があれば足りる
visited_pages_7dstring[]任意—直近30日があれば足りる
visited_pages_30dstring[]必須関心テーマの把握
visited_pages_90dstring[]任意—直近30日があれば足りる
list_namestring必須リスト別の進捗
list_countnumber必須リスト規模の把握
has_callboolean必須チャネル到達状況
call_datedate必須チャネル別の実施時期
has_mailboolean必須チャネル到達状況
mail_sent_datedate必須チャネル別の実施時期
has_formboolean必須チャネル到達状況
form_sent_datedate必須チャネル別の実施時期
has_form_clickboolean必須フォーム経由の反応
form_click_datedate必須反応の時期
has_adboolean必須チャネル到達状況
ad_approach_datedate必須実施時期
has_ad_impressionboolean必須広告の到達
ad_impression_datedate必須実施時期
has_ad_clickboolean必須広告の反応（レポートの主要指標）
ad_click_datedate必須反応の時期
has_appointmentboolean必須アポ獲得企業数（企業ベースのアポ率）

インテント検知実績

1行 ＝ 顧客×KW×週（ビジター/ドメインは企業単位） 全 13 項目 ／ うち必須 12

Superset「Keyword Hit Dashboard」Weekly Hit 相当。ヒット数と検知企業をセットで。

項目名（Superset表記）フィールド名案型 必須度用途・これで出す指標備考
subscription_idstring必須顧客の特定Keyword Hit Dashboard の現行列
company_namestring必須検知された企業現行列
company_idstring必須活動データとの突合キー現行CSVに無い。社名の名寄せを避けるため追加をお願いしたい
weekdate必須週次のヒット推移現行列
target_productstring必須商材別の運用実績現行列。同一KWを複数商材で運用するケースあり
keywordstring必須KW別のヒット数現行列
keyword_start_datedate必須KWの運用開始時期現行列
keyword_expire_datedate必須KWの入れ替え時期現行列
keyword_statusstring必須運用中/停止の判別現行列
hit_30daynumber必須直近30日のヒット数現行列
hit_90daynumber任意—現行列。直近30日があれば足りる
visitor_intent_companiesobject[]必須自社サイト来訪企業の把握企業名・法人ID・閲覧ページ・検知日をセットで
domain_intent_companiesobject[]必須ドメイン単位の検知の把握企業名・法人ID・検知日をセットで

システム連携状況

1行 ＝ 顧客×連携先 全 9 項目 ／ うち必須 9

連携の有無に加えて、生きているかどうか（最終同期・エラー）まで。

項目名（Superset表記）フィールド名案型 必須度用途・これで出す指標備考
subscription_idstring必須顧客の特定
integration_typestring必須何と連携しているかSalesforce / HubSpot / その他
is_enabledboolean必須連携の有無確認いただいた「SF連携やその他」に該当
auth_methodstring必須連携の作り方の把握OAuth / APIキー 等
connected_atdate必須いつから使っているか
last_synced_atdatetime必須連携が生きているかの判定「設定はあるが動いていない」を検出したい
last_sync_statusstring必須同期の成否成功 / 失敗
last_sync_errorstring必須停止理由の特定解約予兆として拾いたい
synced_objectsstring[]必須連携の深さの把握リード / 取引先 / 商談 等

ユーザーのログイン状況

1行 ＝ 顧客×ユーザー（＋Subs単位の集計） 全 10 項目 ／ うち必須 10

ログイン履歴と、契約IDに対する稼働率。

項目名（Superset表記）フィールド名案型 必須度用途・これで出す指標備考
subscription_idstring必須顧客の特定
user_idstring必須ユーザーの特定
user_namestring必須誰が使っているかの特定推進者が異動・退職していないかの検知に使用
rolestring必須管理者が動いているかの判定
is_activeboolean必須発行IDの母数
last_login_atdatetime必須離脱の検知ヘルススコアの主要素
login_countnumber必須利用頻度
issued_seatsnumber必須契約に対する利用の広がりSubs単位の集計として返してほしい
active_seatsnumber必須稼働率（稼働ID÷発行ID）Subs単位の集計
wau_maunumber必須利用の増減トレンドSubs単位の集計

ツールの仕様としてお願いしたいこと項目定義だけでは決まらない、呼び出し方と返し方の部分です