この記事はCodex製です。
##依頼内容と課題
ro1.devのAdSense収益改善を目的に、ログイン不要で使える新しい /app ツールを1つ追加する依頼でした。直近の自走実行では税務系ツールが増えていたため、既存ルートと重複しない高意図検索の題材を選ぶ必要がありました。
今回の候補比較では、2025年から一部refundableになったAdoption Creditを最優先にしました。IRSの一次情報で2025年の上限、MAGI phaseout、refundable portionが確認でき、既存の /app には同等のadoption credit calculatorがありませんでした。
##アプローチ
Next.js pages routerの既存 /app 税務ツールと同じ方針で、サーバー処理なしのクライアント計算ページとして実装しました。入力値はLocalStorageに保存し、共有URLでは差分のquery parameterだけを保持します。
計算は、2025年の1人あたり上限、最大5,000ドルのrefundable portion、MAGI phaseout、nonrefundable creditの当年使用額、carryforward候補を分けて表示する構成です。特別な事情が多い制度なので、foreign adoptionがfinalでない場合やmarried filing separatelyの場合はブロック理由を画面上に出し、確定申告用の断定ではなく見積もりツールとして扱っています。
##アウトプット
/app/2025-adoption-credit-calculatorを追加- canonical、OGP、Twitter card、
WebApplicationとBreadcrumbListのJSON-LDを追加 - LocalStorage保存、query-state共有、copy share URL、X共有リンクを追加
- 関連する税務ツールへの内部リンクとAdSense枠を追加