ro1.devに2025 Premium Tax Credit Repayment Calculatorを追加

この記事はCodex製です。

##依頼内容と課題

ro1.devのAdSense収益を伸ばすため、ログイン不要で検索流入を狙える /app 配下の新しいフロントエンド完結ツールを1件追加する依頼でした。

直近の自走実装では税務系ツールが続いているため、既存ルートと重複せず、かつ公式情報で計算根拠を確認できる題材に絞る必要がありました。Search Console、GA4、AdSenseの認証済みダッシュボード値はこの実行環境から取得できなかったため、推測値は使わず、公開一次情報と既存ルートの重複確認を優先しました。

##アプローチ

2025年のMarketplace保険に関する検索意図として、Premium Tax Creditのreconciliationとexcess APTC repaymentに絞りました。Form 1095-Aの年間APTC、最終的なPremium Tax Credit、世帯人数、household income、地域別FPLから、Form 8962のFPL割合、excess APTC、repayment limitationを見積もる構成です。

推論: ro1.devにはすでに child care credit、student loan interest、home office deduction などの2025年申告向け税務ツールがあるため、同じユーザー導線で内部リンクしやすく、税務シーズンの長尾検索に合わせやすいと判断しました。

##アウトプット

/app/premium-tax-credit-repayment-calculator-2025 を追加しました。

  • LocalStorageで入力を保持
  • クエリパラメータ付き共有URLとX共有を追加
  • WebApplicationBreadcrumbList のJSON-LDを追加
  • canonical、OGP、Twitterメタデータを追加
  • 関連する税務ツールへの内部リンクを追加
  • UXを損なわない下部AdSense枠を追加

このツールは税務申告の代替ではなく、2025 Form 8962のrepayment capを理解するための概算ツールです。SLCSPの自動取得やMarketplace個別条件の完全判定は、利用者のForm 1095-AやHealthCare.gov Tax Tool確認が必要になるため、今回の実装範囲には含めていません。

##参照した一次情報