jiahongc Card Compare
Goal
Return a compact side-by-side comparison of two exact card variants.
Search Strategy: search-required
Fetch both issuer pages in parallel + up to 5 secondary sources total for current offer details. Prefer NerdWallet, The Points Guy, Doctor of Credit, One Mile at a Time, and Bankrate.
Workflow
- Parse two card names from the input (separated by "vs", "versus", "or", or a comma).
- Resolve each card using ../card-identity/SKILL.md. If either is ambiguous, return a numbered choice list for the ambiguous card and stop.
- Run one Brave Search API call (see
search_methodin ../card-shared/source-policy.yaml):
Ifcurl -sS "https://api.search.brave.com/res/v1/web/search?q=CARD_A+vs+CARD_B+compare&count=10" -H "X-Subscription-Token: $BRAVE_API_KEY"$BRAVE_API_KEYis not set, fall back to WebSearch. - Fetch pages — pick the issuer URL for each card and up to 2 secondary URLs (prefer nerdwallet.com and thepointsguy.com) from the search results. Fetch in parallel:
Search snippets are too shallow for accurate comparisons — the actual pages have complete rate tables, credit lists, and benefit details.curl -sS -L "URL" | sed 's/<[^>]*>//g' | tr -s '\n' | head -200 - Apply confidence handling from ../card-shared/confidence-rules.md.
- Return compact markdown using the
card-comparecontract in ../card-shared/command-contracts.yaml. - YAML is internal only — do not include it in user-facing output.
- Do not show a "Why It Matters" section.
Required Sections
## 💰 Fees## 📈 Earning Rates## 🏷️ Credits## 🔄 Transfer Partners## ✈️ Key Benefits## 🏆 Bottom Line## 📋 Confidence Notes## 🔗 Sources— numbered list of URLs fetched, as markdown hyperlinks with short "Site - Topic" labels, e.g.[NerdWallet - CSR vs Amex Gold](https://...)
Omit ## Card Identity when both matches are confident. Use a two-column format (Card A | Card B) for the comparison sections. The Bottom Line section should give a concise factual summary of which card wins in each major dimension — not a recommendation.