fleece-cli 0.3.0__tar.gz → 0.3.1__tar.gz

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/.agents/skills/fleece/SKILL.md

@@ -14,9 +14,36 @@ Use this skill when the user asks about:
 - **Card recommendations**: "Best travel credit card for beginners", "No annual fee cash back card"
 - **ROI / value**: "Is the Amex Platinum worth the $695 fee?", "First-year value of the Sapphire Preferred"
 - **Award redemptions**: "Find business class flights JFK to Tokyo", "Search hotels in Paris with points"
+- **Merchant lookup**: "What card should I use at Costco?", "Which card earns the most at gas stations?", "What MCC is a pharmacy?"
 
 Live US credit card data via Brave Search. All commands output JSON for programmatic use.
 
+## MCC-enriched workflow
+
+The bundled MCC dataset (981 codes, offline) enables a precise end-to-end flow:
+
+```
+fleece wallet          → identify category gaps
+fleece mcc 5411        → confirm "Grocery Stores, Supermarkets"
+fleece mcc 5411 --wallet → find best card for that exact merchant type
+fleece recommend "grocery stores, gas, transit"  → suggest a card to fill the gap
+```
+
+**Common MCCs to know:**
+
+| MCC  | Category | Typical card bonus |
+|------|----------|--------------------|
+| 5411 | Grocery Stores | Amex Gold 4x, BofA Cash Rewards 3% |
+| 5812 | Restaurants | Amex Gold 4x, CSP 3x |
+| 5814 | Fast Food | Varies — not always same as 5812 |
+| 5541 | Gas Stations | Citi Custom Cash 5x, BofA 3% |
+| 4511 | Airlines | Amex Platinum 5x, CSR 3x |
+| 7011 | Hotels | Amex Platinum 5x (Amex Travel), CSR 3x |
+| 4111 | Transit / Commuter | CSR 3x, Bilt 3x |
+| 5912 | Drugstores | Chase Freedom Flex 3x |
+
+Use `fleece mcc <code>` (no API key needed) to resolve any MCC before running a rates or wallet query.
+
 ## Prerequisites
 
 ```bash

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/.claude/skills/fleece-compare.md

@@ -29,3 +29,15 @@ fleece compare "Capital One Venture X" "Chase Sapphire Reserve" --json
 ```
 
 After receiving the result, synthesize a clear recommendation based on the user's stated priorities.
+
+## MCC-precise comparison
+
+When comparing two cards on rewards, use `fleece mcc` to identify the exact merchant category first — then compare on that specific category for a more accurate result:
+
+```bash
+# User wants to know which card earns more at Costco (a grocery/wholesale club)
+fleece mcc 5411   # → Grocery Stores, Supermarkets
+
+# Then compare with that category as the focus
+fleece compare "Amex Gold" "Chase Sapphire Preferred" --aspects "grocery rewards,supermarket earning rate" --json
+```

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/.claude/skills/fleece-rates.md

@@ -27,3 +27,13 @@ Categories: `dining`, `travel`, `groceries`, `gas`, `streaming`, `drugstores`, e
 fleece rates "Chase Sapphire Preferred" --json
 fleece rates "Amex Gold" --category dining --json
 ```
+
+## MCC precision tip
+
+Category names like `dining` are broad — a card may earn differently at MCC 5812 (sit-down restaurants) vs 5814 (fast food) vs 5411 (grocery stores with a café). When exact merchant-level precision matters, pair with `fleece mcc`:
+
+```bash
+# Confirm the MCC for the merchant type, then look up the rate
+fleece mcc 5814   # → Fast Food Restaurants
+fleece rates "Amex Gold" --category "fast food restaurants" --json
+```

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/.claude/skills/fleece-recommend.md

@@ -30,3 +30,19 @@ fleece recommend "frequent international traveler" --preferences "priority pass
 ```
 
 After receiving results, present 2–3 top recommendations with a brief rationale for each.
+
+## MCC-informed spending profiles
+
+For more precise recommendations, identify the MCC codes for the user's top merchants first, then describe the profile by category name:
+
+```bash
+# User shops at Whole Foods (5411), commutes by subway (4111), eats out often (5812)
+fleece mcc 5411   # → Grocery Stores, Supermarkets
+fleece mcc 4111   # → Transportation / Commuter
+fleece mcc 5812   # → Eating Places, Restaurants
+
+# Then recommend based on confirmed categories
+fleece recommend "grocery stores, transit, restaurants" --json
+```
+
+This avoids vague profiles like "I spend a lot on food" and maps the user's real spend to known card bonus categories.

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/.claude/skills/fleece-wallet.md

@@ -60,3 +60,20 @@ fleece wallet
 # Explicit cards
 fleece wallet "Amex Gold" "Chase Sapphire Preferred" "Citi Double Cash"
 ```
+
+## MCC-enriched gap analysis
+
+After `fleece wallet` identifies a gap (e.g., "no bonus on grocery stores"), use `fleece mcc` to drill into the precise merchant category and find the best card for it:
+
+```bash
+# Wallet says "gap on groceries" → confirm the MCC and cross-reference wallet
+fleece mcc 5411 --wallet --json   # Grocery Stores, Supermarkets
+
+# Other common gap MCCs to check after a wallet analysis
+fleece mcc 5541 --wallet          # Gas stations
+fleece mcc 5912 --wallet          # Drugstores / pharmacies
+fleece mcc 4111 --wallet          # Transit / commuter
+fleece mcc 5812 --wallet          # Restaurants
+```
+
+This turns a vague "gap on groceries" into a precise card recommendation for a specific merchant category.

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fleece-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: Credit card research and redemption CLI — live data via Brave Search, PointsYeah URL generation, designed for humans and AI agents.
 Author-email: Yuan Chen <cysbc1999@gmail.com>
 License: MIT

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/cli.py

@@ -4,10 +4,13 @@ Fleece CLI — agent-friendly companion to the Fleece Streamlit chatbot.
 Exposes credit card research tools as shell commands backed by Brave Search.
 Designed for use by AI agents (Claude Code, Codex) and humans alike.
 
+BRAVE_API_KEY is optional — commands that don't need live search (mcc, flights,
+hotels) work fully offline. Research commands (card, rates, wallet, …) require it.
+
 Exit codes:
   0  success
   1  search / tool error
-  2  configuration error (missing API key)
+  2  BRAVE_API_KEY required but not set
 """
 import json
 import sys
@@ -18,7 +21,11 @@ from dotenv import load_dotenv
 
 app = typer.Typer(
     name="fleece",
-    help="Fleece credit card research CLI — live data via Brave Search.",
+    help=(
+        "Fleece credit card research CLI — live data via Brave Search.\n\n"
+        "BRAVE_API_KEY is optional: mcc, flights, and hotels work offline.\n"
+        "Research commands (card, rates, wallet, …) require it."
+    ),
     no_args_is_help=True,
 )
 
@@ -27,20 +34,21 @@ app = typer.Typer(
 # ---------------------------------------------------------------------------
 
 def _resolve_key(api_key: Optional[str], no_dotenv: bool) -> str:
-    """Load env and return the Brave API key, or exit with code 2."""
+    """Load env and return the Brave API key (may be empty — checked at use time)."""
     import os
     if not no_dotenv:
         load_dotenv()
-    key = api_key or os.getenv("BRAVE_API_KEY", "")
+    return api_key or os.getenv("BRAVE_API_KEY", "")
+
+
+def _get_wrapper(key: str, freshness: Optional[str] = None):
     if not key:
         _error_exit(
-            "BRAVE_API_KEY not set. Pass --api-key or add it to .env.",
+            "BRAVE_API_KEY is required for live research. "
+            "Set it in your environment, add it to .env, or pass --api-key. "
+            "Commands mcc, flights, and hotels work without it.",
             code=2,
         )
-    return key
-
-
-def _get_wrapper(key: str, freshness: Optional[str] = None):
     from tools.brave_client import build_brave_wrapper
     return build_brave_wrapper(key, freshness=freshness)
 

fleece_cli-0.3.1/docs/SEO.md

@@ -0,0 +1,113 @@
+# ClawHub Skill SEO Log
+
+Tracking description changes, tag updates, and search ranking results for the `fleece` skill on ClawHub.
+
+---
+
+## v1.0.0 — Initial publish (2026-05-18)
+
+**Description:**
+> Fleece credit card research CLI. Provides live US credit card data via Brave Search — full reports, earning rates, transfer partners, statement credits, recent news, card comparisons, portfolio analysis, ROI estimates, and profile-based recommendations. Install with `pip install fleece-cli`. Use whenever you need current credit card information.
+
+**Tags:** `latest`
+
+**Search results:**
+| Query | Rank | Score |
+|---|---|---|
+| `credit card` | #13 | 0.701 |
+
+**Issues identified:**
+- Generic name "Fleece" gives no signal to vector search
+- Description truncated in results — key terms buried
+- No categorical tags
+- Zero results for conversational queries like "what card should I use for dining"
+
+---
+
+## v1.1.0 — Keyword-rich description + tags (2026-05-18)
+
+**Changes:**
+- Rewrote description to front-load issuer names (Chase, Amex, Citi, Capital One, Bilt) and reward types (points, miles, cash back, annual fees, welcome bonuses, transfer partners)
+- Added "Use this skill when..." section with 8 natural-language trigger phrases near top of SKILL.md body
+- Added 14 categorical tags
+
+**Tags:** `latest, credit-cards, rewards, points, miles, travel, finance, research, amex, chase, citi, capital-one, brave-search, wallet, transfer-partners`
+
+**Search results:**
+| Query | Rank | Score |
+|---|---|---|
+| `credit card research` | **#1** | 0.817 |
+| `credit card redemption` | **#1** | 0.782 |
+| `credit card` | #13 | 0.702 |
+| `what card should I use for dining` | — | no results |
+
+---
+
+## v1.1.1 — Conversational query language (2026-05-18)
+
+**Changes:**
+- Rewrote description opening to directly mirror user query phrasing:
+  > "What credit card should I use for dining, travel, groceries, or gas?" — Fleece answers this with live data...
+- Added `recommendations`, `dining`, `groceries`, `gas` tags
+
+**Rationale:** Vector search scores on embedding similarity — starting the description with the exact question users ask maximizes cosine similarity for that query bucket.
+
+**Tags:** `latest, credit-cards, rewards, points, miles, travel, finance, research, amex, chase, citi, capital-one, brave-search, wallet, transfer-partners, recommendations, dining, groceries, gas`
+
+**Search results:**
+| Query | Rank | Score |
+|---|---|---|
+| `credit card research` | **#1** | 0.817 |
+| `credit card redemption` | **#1** | 0.782 |
+| `what card should I use for dining` | — | no results (below threshold) |
+
+**Note:** ClawHub has a minimum score threshold (~0.6–0.7). Conversational queries fall below it for all skills — not specific to fleece. Vector index update lag (~minutes) observed between publish and ranking change.
+
+---
+
+## v1.2.0 — MCC command added (2026-05-18)
+
+**Changes:**
+- Added `fleece mcc` command (offline MCC code lookup + wallet cross-reference)
+- Added `mcc`, `merchant-category` tags
+
+**Tags:** added `mcc, merchant-category`
+
+---
+
+## v1.2.1 — Claude skill for MCC published (2026-05-18)
+
+**Changes:**
+- Added `fleece-mcc.md` Claude Code skill
+- No description change
+
+---
+
+## v1.3.0 — MCC-enriched workflows across all skills (2026-05-18)
+
+**Changes:**
+- Added merchant lookup as an explicit trigger phrase in agent SKILL.md:
+  > "What card should I use at Costco?", "Which card earns the most at gas stations?", "What MCC is a pharmacy?"
+- Added MCC workflow table to agent SKILL.md mapping common codes to typical card bonuses (5411 groceries, 5812 restaurants, 5541 gas, 4511 airlines, 7011 hotels, 4111 transit, 5912 drugstores)
+- **fleece-wallet**: added post-gap-analysis MCC flow (`fleece mcc <code> --wallet`)
+- **fleece-rates**: added MCC precision tip (5812 vs 5814 vs 5411 distinctions)
+- **fleece-recommend**: added MCC-informed spending profile workflow
+- **fleece-compare**: added MCC-precise comparison example
+
+**Rationale:** MCC lookup answers "what card should I use at [merchant]?" with precision. Cross-referencing wallet gaps with MCC codes turns vague category gaps into specific merchant-level card recommendations. Adding merchant phrasing to trigger phrases broadens the query surface the skill matches.
+
+**Tags:** unchanged from v1.2.1
+
+---
+
+## Observations & lessons
+
+1. **Description is the primary ranking signal** — ClawHub's vector search indexes the frontmatter `description` field. The body content appears to have lower weight. Front-load the highest-value keywords.
+
+2. **Conversational queries hit a threshold floor** — queries phrased as full sentences ("what card should I use for...") return 0 results across all skills, suggesting the registry-wide similarity is below ClawHub's cutoff for this query type. Not a fleece-specific problem.
+
+3. **Intent buckets matter** — "credit card" ranks us #13 because the top results are payment/spend skills (giving agents a card to transact). We're a research tool — different intent, different bucket. Competing in the right bucket ("credit card research", "credit card redemption") yields #1 rankings.
+
+4. **Tags are for filtering, not ranking** — adding tags didn't move needle on search scores but helps with tag-based browsing.
+
+5. **Index update lag** — ClawHub rebuilds vector embeddings asynchronously after publish. The `inspect` summary field reflects the old content until the rebuild completes. Wait ~5–10 minutes before testing ranking changes.

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/docs/index.html

@@ -3,7 +3,56 @@
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Fleece — Find the best card for deal saviors</title>
+
+  <!-- Primary SEO -->
+  <title>Fleece — Credit Card Research CLI & Rewards Optimizer</title>
+  <meta name="description" content="Fleece is a free, open-source CLI that researches credit cards with live data. Compare Chase, Amex, Citi, and Capital One cards — earning rates, transfer partners, statement credits, ROI, and MCC-level merchant lookup. pip install fleece-cli." />
+  <meta name="robots" content="index, follow" />
+  <meta name="author" content="Yuan Chen" />
+  <link rel="canonical" href="https://getfleece.io/" />
+  <meta name="google-site-verification" content="9DkACCiooe0-omtkzGJUZJPqoG0HAj4QejFEom9wrGA" />
+
+  <!-- Open Graph -->
+  <meta property="og:type" content="website" />
+  <meta property="og:url" content="https://getfleece.io/" />
+  <meta property="og:title" content="Fleece — Credit Card Research CLI & Rewards Optimizer" />
+  <meta property="og:description" content="Research credit cards with live data. Compare Chase, Amex, Citi, Capital One — earning rates, transfer partners, ROI, MCC lookup, and award flight search. Free and open source." />
+  <meta property="og:site_name" content="Fleece" />
+
+  <!-- Twitter Card -->
+  <meta name="twitter:card" content="summary" />
+  <meta name="twitter:title" content="Fleece — Credit Card Research CLI & Rewards Optimizer" />
+  <meta name="twitter:description" content="Research credit cards with live data. Compare Chase, Amex, Citi, Capital One — earning rates, transfer partners, ROI, MCC lookup, and award flight search. Free and open source." />
+
+  <!-- JSON-LD Structured Data -->
+  <script type="application/ld+json">
+  {
+    "@context": "https://schema.org",
+    "@type": "SoftwareApplication",
+    "name": "Fleece",
+    "alternateName": "fleece-cli",
+    "applicationCategory": "FinanceApplication",
+    "operatingSystem": "macOS, Linux, Windows",
+    "programmingLanguage": "Python",
+    "offers": {
+      "@type": "Offer",
+      "price": "0",
+      "priceCurrency": "USD"
+    },
+    "description": "Fleece is an open-source credit card research CLI. Look up earning rates, transfer partners, statement credits, annual fees, and first-year ROI for Chase, Amex, Citi, Capital One, and all major US issuers. Includes offline MCC merchant category lookup and PointsYeah award flight and hotel search.",
+    "url": "https://getfleece.io/",
+    "downloadUrl": "https://pypi.org/project/fleece-cli/",
+    "softwareVersion": "0.3.0",
+    "license": "https://github.com/chenyuan99/fleece/blob/main/LICENSE",
+    "codeRepository": "https://github.com/chenyuan99/fleece",
+    "author": {
+      "@type": "Person",
+      "name": "Yuan Chen"
+    },
+    "keywords": "credit card research, rewards optimizer, transfer partners, MCC lookup, Chase Sapphire, Amex Gold, Citi, Capital One, points miles cash back"
+  }
+  </script>
+
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
   <link href="https://fonts.googleapis.com/css2?family=Oswald:wght@400;600;700&family=Source+Sans+3:wght@400;600&display=swap" rel="stylesheet">
@@ -463,7 +512,7 @@
 <section class="hero">
   <div class="hero-inner">
     <div>
-      <h1>Find the best card for <span>deal saviors</span></h1>
+      <h1>Credit card research for <span>deal saviors</span></h1>
       <p>AI-powered credit card research and award redemption. Live data via Brave Search, PointsYeah flight and hotel search — every command outputs clean JSON, built for humans and AI agents alike.</p>
       <div class="hero-actions">
         <a class="btn-pill-dark" href="https://github.com/chenyuan99/fleece" target="_blank">
@@ -476,7 +525,7 @@
     <div class="hero-install-box">
       <h2>Install CLI</h2>
       <div class="install-cmd"><span>$</span> pip install fleece-cli</div>
-      <p>Set <code style="color:rgba(255,255,255,0.5);font-size:0.85em">BRAVE_API_KEY</code> in your environment and run <code style="color:rgba(255,255,255,0.5);font-size:0.85em">fleece --help</code> to get started. Requires Python 3.11+.</p>
+      <p><code style="color:rgba(255,255,255,0.5);font-size:0.85em">BRAVE_API_KEY</code> is optional — <code style="color:rgba(255,255,255,0.5);font-size:0.85em">mcc</code>, <code style="color:rgba(255,255,255,0.5);font-size:0.85em">flights</code>, and <code style="color:rgba(255,255,255,0.5);font-size:0.85em">hotels</code> work fully offline. Live research commands require it. Requires Python 3.11+.</p>
     </div>
   </div>
 </section>
@@ -520,7 +569,7 @@
         <path d="M38 28l8-4-2 8" stroke="black" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>
       </svg>
       <h3>Redemption</h3>
-      <p>Generate PointsYeah search URLs for award flights and hotels — no API key needed. Pure URL generation, open directly in your browser or pipe into an agent workflow.</p>
+      <p>Look up any merchant category code to find your best card at checkout. Generate PointsYeah search URLs for award flights and hotels. No API key needed for either — works fully offline.</p>
       <a class="btn-arrow" href="#commands" >
         See commands
         <svg viewBox="0 0 16 16" fill="none"><path d="M3 8h10M9 4l4 4-4 4" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"/></svg>
@@ -533,8 +582,8 @@
 <!-- ABOUT -->
 <section class="announcement">
   <div class="announcement-inner">
-    <h2>About</h2>
-    <p>Fleece is an open-source credit card research tool built for people who take rewards seriously. Unlike chatbots that rely on stale training data, Fleece pulls live information from the web on every query — so you always get current fees, earning rates, and benefit details. The CLI is designed to work seamlessly with AI agents: every command supports <code style="font-size:0.95em;background:rgba(0,0,0,0.06);padding:1px 5px;border-radius:3px">--json</code> output and reads from stdin, so it plugs into any workflow.</p>
+    <h2>About Fleece</h2>
+    <p>Fleece is a free, open-source credit card research tool built for people who take rewards seriously. Unlike chatbots that rely on stale training data, Fleece pulls live information from the web on every query — so you always get current fees, earning rates, and benefit details. The CLI is designed to work seamlessly with AI agents: every command supports <code style="font-size:0.95em;background:rgba(0,0,0,0.06);padding:1px 5px;border-radius:3px">--json</code> output and reads from stdin, so it plugs into any workflow.</p>
     <a class="btn-arrow" href="https://github.com/chenyuan99/fleece" target="_blank" style="background:var(--black);color:var(--white);">
       Read the docs
       <svg viewBox="0 0 16 16" fill="none" width="14" height="14"><path d="M3 8h10M9 4l4 4-4 4" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"/></svg>
@@ -542,6 +591,62 @@
   </div>
 </section>
 
+<!-- AGENT INTEGRATION -->
+<section class="cards-section" id="agents" style="border-top: 1px solid var(--border);">
+  <div style="max-width:1100px;margin:0 auto;padding:0 0 2rem;">
+    <p class="section-label" style="color:var(--mid);font-size:0.72rem;font-weight:800;letter-spacing:2px;text-transform:uppercase;margin-bottom:0.6rem;">Agent Integration</p>
+    <h2 style="font-family:var(--font-head);font-size:clamp(1.75rem,3vw,2.2rem);font-weight:900;letter-spacing:-0.5px;margin-bottom:0.75rem;">Works with your AI agent</h2>
+    <p style="font-size:1rem;color:var(--mid);max-width:540px;margin-bottom:2.5rem;">Install once and every supported agent gains access to all 12 Fleece commands — research, wallet analysis, MCC lookup, and award redemption.</p>
+  </div>
+
+  <div class="cards-inner" style="grid-template-columns: repeat(3, 1fr);">
+
+    <div class="card">
+      <svg class="card-icon" viewBox="0 0 60 60" fill="none" xmlns="http://www.w3.org/2000/svg">
+        <rect x="8" y="8" width="44" height="44" rx="8" stroke="black" stroke-width="2.5"/>
+        <path d="M20 30h20M20 22h12M20 38h16" stroke="black" stroke-width="2.5" stroke-linecap="round"/>
+      </svg>
+      <h3>Claude Code</h3>
+      <p>Install 12 slash commands directly into your Claude Code session. Use <code style="font-size:0.85em;background:#f0f0f0;padding:1px 4px;border-radius:3px">/fleece-wallet</code>, <code style="font-size:0.85em;background:#f0f0f0;padding:1px 4px;border-radius:3px">/fleece-mcc</code>, and more without leaving the terminal.</p>
+      <div style="font-family:'Courier New',monospace;font-size:0.8rem;background:#f7f7f5;border:1px solid var(--border);border-radius:6px;padding:0.9rem 1rem;line-height:1.8;">
+        <div><span style="color:var(--mid)">$</span> bash install.sh --claude</div>
+        <div style="color:var(--mid);font-size:0.75rem;margin-top:4px">/fleece-card &nbsp;/fleece-wallet &nbsp;/fleece-mcc</div>
+        <div style="color:var(--mid);font-size:0.75rem">/fleece-flights &nbsp;/fleece-hotels &nbsp;+7 more</div>
+      </div>
+    </div>
+
+    <div class="card">
+      <svg class="card-icon" viewBox="0 0 60 60" fill="none" xmlns="http://www.w3.org/2000/svg">
+        <circle cx="30" cy="30" r="22" stroke="black" stroke-width="2.5"/>
+        <path d="M22 30c0-4.4 3.6-8 8-8s8 3.6 8 8-3.6 8-8 8" stroke="black" stroke-width="2.5" stroke-linecap="round"/>
+        <circle cx="30" cy="30" r="3" fill="black"/>
+      </svg>
+      <h3>OpenClaw &amp; Codex</h3>
+      <p>Install the agent skill to give OpenClaw or Codex full Fleece capability — card research, wallet gaps, MCC lookup, and redemption, all in one skill.</p>
+      <div style="font-family:'Courier New',monospace;font-size:0.8rem;background:#f7f7f5;border:1px solid var(--border);border-radius:6px;padding:0.9rem 1rem;line-height:1.8;">
+        <div><span style="color:var(--mid)">$</span> bash install.sh --agents</div>
+        <div style="color:var(--mid);font-size:0.75rem;margin-top:4px">.agents/skills/fleece/SKILL.md</div>
+        <div style="color:var(--mid);font-size:0.75rem">or: clawhub install fleece</div>
+      </div>
+    </div>
+
+    <div class="card">
+      <svg class="card-icon" viewBox="0 0 60 60" fill="none" xmlns="http://www.w3.org/2000/svg">
+        <path d="M10 20l20-10 20 10v20L30 50 10 40V20z" stroke="black" stroke-width="2.5" stroke-linejoin="round"/>
+        <path d="M30 40V20M10 20l20 10 20-10" stroke="black" stroke-width="2.5" stroke-linejoin="round"/>
+      </svg>
+      <h3>ClawHub Registry</h3>
+      <p>Fleece is published on ClawHub. Any agent that supports the ClawHub registry can install and use it with a single command — no git clone required.</p>
+      <div style="font-family:'Courier New',monospace;font-size:0.8rem;background:#f7f7f5;border:1px solid var(--border);border-radius:6px;padding:0.9rem 1rem;line-height:1.8;">
+        <div><span style="color:var(--mid)">$</span> clawhub install fleece</div>
+        <div style="color:var(--mid);font-size:0.75rem;margin-top:4px">fleece@1.3.0 &nbsp;·&nbsp; MIT-0</div>
+        <div style="color:var(--mid);font-size:0.75rem">clawhub search "credit card research"</div>
+      </div>
+    </div>
+
+  </div>
+</section>
+
 <!-- COMMANDS + LINKS -->
 <section class="contact-section" id="commands">
   <div class="contact-inner">
@@ -585,6 +690,7 @@
         <div class="cmd-row"><span class="cmd-name">fleece wallet</span><span class="cmd-desc">Portfolio analysis — coverage, overlaps, gaps</span></div>
         <div class="cmd-row"><span class="cmd-name">fleece roi</span><span class="cmd-desc">First-year ROI estimate by spend profile</span></div>
         <div class="cmd-row"><span class="cmd-name">fleece recommend</span><span class="cmd-desc">Card recommendations for a spending profile</span></div>
+        <div class="cmd-row"><span class="cmd-name" style="color:var(--yellow)">fleece mcc</span><span class="cmd-desc">Look up a merchant category code — find your best card at checkout</span></div>
         <div class="cmd-row"><span class="cmd-name" style="color:var(--yellow)">fleece flights</span><span class="cmd-desc">PointsYeah award flight search URL — no API key needed</span></div>
         <div class="cmd-row"><span class="cmd-name" style="color:var(--yellow)">fleece hotels</span><span class="cmd-desc">PointsYeah award hotel search URL — no API key needed</span></div>
       </div>

fleece_cli-0.3.1/docs/robots.txt

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+
+Sitemap: https://getfleece.io/sitemap.xml

fleece_cli-0.3.1/docs/sitemap.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://getfleece.io/</loc>
+    <lastmod>2026-05-18</lastmod>
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+</urlset>

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/install.sh

@@ -20,8 +20,9 @@ install_claude() {
     cp "$f" "$dest"
   done
   echo "✓ Claude Code skills installed to $TARGET/"
-  echo "  Slash commands: /fleece-card /fleece-rates /fleece-partners /fleece-credits"
-  echo "                  /fleece-news /fleece-compare /fleece-wallet /fleece-roi /fleece-recommend"
+  echo "  Research:    /fleece-card /fleece-rates /fleece-partners /fleece-credits"
+  echo "               /fleece-news /fleece-compare /fleece-wallet /fleece-roi /fleece-recommend"
+  echo "  Redemption:  /fleece-mcc /fleece-flights /fleece-hotels"
 }
 
 install_agents() {
@@ -58,4 +59,5 @@ case "${1:-auto}" in
 esac
 
 echo ""
-echo "Set BRAVE_API_KEY in your environment or .env file to enable live research."
+echo "BRAVE_API_KEY is optional — mcc, flights, and hotels work without it."
+echo "Set BRAVE_API_KEY in your environment or .env file to enable live research commands."

{fleece_cli-0.3.0 → fleece_cli-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "fleece-cli"
-version = "0.3.0"
+version = "0.3.1"
 description = "Credit card research and redemption CLI — live data via Brave Search, PointsYeah URL generation, designed for humans and AI agents."
 readme = "README.md"
 license = { text = "MIT" }