@first-ch/tools-mcp 0.51.0 → 0.52.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/ai-vs-search.mjs +16 -1
  2. package/package.json +2 -2
package/ai-vs-search.mjs CHANGED
@@ -235,6 +235,8 @@ export const T = {
235
235
  aiZero: 'AI Assistant の行がありません(この期間の AI からの訪問が0か、表の行数を減らして書き出したかもしれません)。',
236
236
  lowSample: 'AI Assistant が30セッション未満のため、倍率は出さず、数は参考値です。',
237
237
  searchZero: 'Organic Search の行がないため、倍率は出していません。',
238
+ noMetrics: '比べられる指標がないため、倍率は出していません(エンゲージのあったセッション数・平均エンゲージメント時間・キーイベントの列がないか、検索側の値が0です)。',
239
+ keyEventRate: 'キーイベント率=キーイベント÷セッション(100%を超えることがあります)。GA4 の「セッションのキーイベント率」とは別の数です。',
238
240
  duplicate: '同じチャネルが2行以上あります。比較やセカンダリ ディメンションを付けたまま書き出していないか確かめてください(各行はそのまま足しています)。',
239
241
  noEngaged: '「エンゲージのあったセッション数」の列がないため、エンゲージメント率は出していません。',
240
242
  noAvgTime: '「セッションあたりの平均エンゲージメント時間」の列がないため、平均エンゲージメント時間は出していません。',
@@ -266,6 +268,8 @@ export const T = {
266
268
  aiZero: 'There is no AI Assistant row (no AI visits in this period, or the table was exported with fewer rows).',
267
269
  lowSample: 'AI Assistant has fewer than 30 sessions, so no ratios are shown and the numbers are for reference only.',
268
270
  searchZero: 'There is no Organic Search row, so no ratios are shown.',
271
+ noMetrics: 'There is no metric to compare, so no ratios are shown (the Engaged sessions, Average engagement time and Key events columns are missing, or the search value is 0).',
272
+ keyEventRate: 'Key event rate = key events ÷ sessions (it can exceed 100%). It is not GA4’s “Session key event rate”.',
269
273
  duplicate: 'The same channel appears on more than one row. Check that no comparison or secondary dimension was on when you exported (each row was added as is).',
270
274
  noEngaged: 'There is no Engaged sessions column, so engagement rate is not shown.',
271
275
  noAvgTime: 'There is no Average engagement time per session column, so engagement time is not shown.',
@@ -296,6 +300,15 @@ export function fmtMetric(k, v, lang) { return k === 'avgEngagementTime' ? fmtTi
296
300
 
297
301
  export const METRIC_KEYS = ['engagementRate', 'avgEngagementTime', 'keyEventRate'];
298
302
 
303
+ /** 倍率が1つも出ないときの理由(倍率があるときは null)。検索の行があっても、比べられる列が無ければ noMetrics */
304
+ export function noRatioReason(r) {
305
+ if (METRIC_KEYS.some((k) => r.ratios[k] != null)) return null;
306
+ if (r.aiZero) return 'aiZero';
307
+ if (r.lowSample) return 'lowSample';
308
+ if (!r.groups.search.sessions) return 'searchZero';
309
+ return 'noMetrics';
310
+ }
311
+
299
312
  /** 上司や制作会社へ貼る要約(プレーンテキスト) */
300
313
  export function summaryText(r, lang = 'ja', url = 'https://tools.first-ch.com/ai-vs-search/') {
301
314
  const L = T[lang === 'en' ? 'en' : 'ja'];
@@ -306,10 +319,11 @@ export function summaryText(r, lang = 'ja', url = 'https://tools.first-ch.com/ai
306
319
  lines.push(head + ' / ' + METRIC_KEYS.map((k) => L.metrics[k] + ' ' + fmtMetric(k, m[k], lang)).join(' / '));
307
320
  }
308
321
  const rs = METRIC_KEYS.filter((k) => r.ratios[k] != null).map((k) => L.ratioLine(L.metrics[k], r.ratios[k]));
309
- lines.push(rs.length ? (lang === 'en' ? 'AI vs search: ' : 'AI と検索の比: ') + rs.join(lang === 'en' ? ', ' : '・') : L.noRatio + '(' + (r.aiZero ? L.notes.aiZero : r.lowSample ? L.notes.lowSample : L.notes.searchZero) + ')');
322
+ lines.push(rs.length ? (lang === 'en' ? 'AI vs search: ' : 'AI と検索の比: ') + rs.join(lang === 'en' ? ', ' : '・') : L.noRatio + (lang === 'en' ? ' (' : '(') + L.notes[noRatioReason(r)] + (lang === 'en' ? ')' : ')'));
310
323
  if (r.totals.basis !== 'matched') lines.push(L.basis[r.totals.basis] + ': ' + L.sessions(r.totals.read.sessions));
311
324
  if (r.excluded.length) lines.push(L.excluded(r.excluded.map((e) => e.line)));
312
325
  for (const n of r.notes) if (['periodUnknown', 'allBeforeAiChannel', 'beforeAiChannel', 'duplicate'].includes(n)) lines.push('※' + L.notes[n]);
326
+ if (r.groups.ai.keyEventRate != null || r.groups.search.keyEventRate != null) lines.push('※' + L.notes.keyEventRate);
313
327
  lines.push('※' + L.fineLong);
314
328
  if (url) lines.push(url);
315
329
  return lines.join('\n');
@@ -357,6 +371,7 @@ export async function aiVsSearchTool(opts = {}) {
357
371
  return {
358
372
  ...r,
359
373
  labels: { groups: L.groups, metrics: L.metrics, basis: L.basis[r.totals.basis] },
374
+ noRatioReason: noRatioReason(r),
360
375
  noteTexts: r.notes.map((n) => L.notes[n]),
361
376
  excludedTexts: r.excluded.map((e) => ({ line: e.line, reason: L.reason[e.reason] })),
362
377
  caveat: L.fineLong,
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@first-ch/tools-mcp",
3
- "version": "0.51.0",
4
- "description": "First CH Tools の計算ロジック(WCAGコントラスト比・文字数/Xウェイト・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4/ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・TSV/CSVからMarkdownテーブルへの整形と相互変換・SQLクエリの整形と予約語の大文字化・URL/テキストからのQRコード生成・UNIXタイムスタンプと日時表記の相互変換・robots.txtの生成(AIクローラーの許可プリセット付き)・文字列のケース変換(camelCase/snake_case/kebab-case など11形式)・CSV/TSVとJSON配列の相互変換(区切りの自動判定・a.b 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理)・IPアドレス/CIDRの計算(ネットワーク・ブロードキャスト・ホスト範囲とホスト数・IPv4/IPv6・サブネット分割・包含判定・IP範囲→最小CIDR集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表)・日本語タイトルからのURLスラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記)・Basic認証用 htpasswd の生成と照合(bcrypt / apr1-md5・パスワードの自動生成・Apache / nginx の設定スニペット)・OpenAPI/Swagger仕様書から日本語のMarkdownドキュメントとTypeScript型定義の生成(OpenAPI 3.x / Swagger 2.0・YAML/JSON・$ref/allOf/oneOf 対応・エンドポイントごとの引数/レスポンス型・外部 $ref は読みに行かない)・FAQ構造化データ(FAQPage の JSON-LD・Markdown・details/summary の HTML を同時生成・回答のリンク/箇条書きを HTML 化・「Q: / A:」形式の一括貼り付けの解析)・テキストの行操作(重複行の削除・数値を認識する並べ替え・シード付きシャッフル・行番号・空行除去・前後トリム・接頭辞/接尾辞)・印刷サイズとDPIの計算(用紙×解像度×塗り足しから必要なピクセル数・手持ちの画像の実効dpiと判定・早見表・mm/inch/px/pt/級の換算)・SERPのメタタグ文字数チェック(title / description が検索結果に収まるかをピクセル幅で判定・切り詰め位置と表示行・パンくず表示・https や階層の指摘)・Flexbox / CSS GridのCSS生成(既定値を省いた宣言・repeat()への畳み込み・grid-template-areasの検証・効かない組み合わせの指摘・定番プリセット)・社内文書の点検(Notion・Confluence などから書き出した Markdown/HTML の重複ページ・孤立ページ・表記ゆれや旧称・リンク切れの検出と修正案)・記入欄に収める字の大きさと改行位置(中袋〔ご祝儀袋・香典袋〕の住所欄などの幅・高さmmから1字の大きさ・行数・改行位置・縦書きの漢数字・金額の大字)・AIが書いた返信案と届いたメールの照合(原文に無い日付・曜日・時刻・金額・数量・電話・宛名を赤、消し忘れの仮の文字を黄)・ComfyUI画像(PNG)の埋め込みデータに残ったAPIキーの形の点検(ノードIDと入力欄で場所を示し値は伏せる・持ち主へのお知らせ文・文字のチャンクを抜いたコピー))をMCPツールとして提供するサーバー。あわせて apps.first-ch.com のWebアプリ39本(GEO・メタタグ・セキュリティヘッダー・SSL・DNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・ビジネス文面チェック等)の JSON API を呼ぶ app_* ツールも提供する(こちらは入力を apps.first-ch.com へ送るため既定では無効・FIRSTCH_ENABLE_APPS=1 で有効)",
3
+ "version": "0.52.0",
4
+ "description": "First CH Tools の計算ロジック(WCAGコントラスト比・文字数/Xウェイト・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4/ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・TSV/CSVからMarkdownテーブルへの整形と相互変換・SQLクエリの整形と予約語の大文字化・URL/テキストからのQRコード生成・UNIXタイムスタンプと日時表記の相互変換・robots.txtの生成(AIクローラーの許可プリセット付き)・文字列のケース変換(camelCase/snake_case/kebab-case など11形式)・CSV/TSVとJSON配列の相互変換(区切りの自動判定・a.b 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理)・IPアドレス/CIDRの計算(ネットワーク・ブロードキャスト・ホスト範囲とホスト数・IPv4/IPv6・サブネット分割・包含判定・IP範囲→最小CIDR集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表)・日本語タイトルからのURLスラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記)・Basic認証用 htpasswd の生成と照合(bcrypt / apr1-md5・パスワードの自動生成・Apache / nginx の設定スニペット)・OpenAPI/Swagger仕様書から日本語のMarkdownドキュメントとTypeScript型定義の生成(OpenAPI 3.x / Swagger 2.0・YAML/JSON・$ref/allOf/oneOf 対応・エンドポイントごとの引数/レスポンス型・外部 $ref は読みに行かない)・FAQ構造化データ(FAQPage の JSON-LD・Markdown・details/summary の HTML を同時生成・回答のリンク/箇条書きを HTML 化・「Q: / A:」形式の一括貼り付けの解析)・テキストの行操作(重複行の削除・数値を認識する並べ替え・シード付きシャッフル・行番号・空行除去・前後トリム・接頭辞/接尾辞)・印刷サイズとDPIの計算(用紙×解像度×塗り足しから必要なピクセル数・手持ちの画像の実効dpiと判定・早見表・mm/inch/px/pt/級の換算)・SERPのメタタグ文字数チェック(title / description が検索結果に収まるかをピクセル幅で判定・切り詰め位置と表示行・パンくず表示・https や階層の指摘)・Flexbox / CSS GridのCSS生成(既定値を省いた宣言・repeat()への畳み込み・grid-template-areasの検証・効かない組み合わせの指摘・定番プリセット)・社内文書の点検(Notion・Confluence などから書き出した Markdown/HTML の重複ページ・孤立ページ・表記ゆれや旧称・リンク切れの検出と修正案)・記入欄に収める字の大きさと改行位置(中袋〔ご祝儀袋・香典袋〕の住所欄などの幅・高さmmから1字の大きさ・行数・改行位置・縦書きの漢数字・金額の大字)・AIが書いた返信案と届いたメールの照合(原文に無い日付・曜日・時刻・金額・数量・電話・宛名を赤、消し忘れの仮の文字を黄)・ComfyUI画像(PNG)の埋め込みデータに残ったAPIキーの形の点検(ノードIDと入力欄で場所を示し値は伏せる・持ち主へのお知らせ文・文字のチャンクを抜いたコピー)・GA4「トラフィック獲得」のCSVから AI Assistant と Organic Search の訪問をエンゲージメント率・平均エンゲージメント時間・キーイベント率で比べる集計(倍率・総計行との突き合わせ・除外した行の行番号・要約))をMCPツールとして提供するサーバー。あわせて apps.first-ch.com のWebアプリ39本(GEO・メタタグ・セキュリティヘッダー・SSL・DNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・ビジネス文面チェック等)の JSON API を呼ぶ app_* ツールも提供する(こちらは入力を apps.first-ch.com へ送るため既定では無効・FIRSTCH_ENABLE_APPS=1 で有効)",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "firstch-tools-mcp": "server.mjs"