IntentParse - Semantic Search Intent Classifier for E-Commerce Product Catalogs

Your Shopify search bar thinks 'red running shoe for flat feet' means 'find the word red'. IntentParse trains a lightweight semantic intent classifier on your product catalog so customers actually find what they meant, not what they typed.

𝕏 Post Reddit HN

Difficulty

intermediate

What is it?

E-commerce stores with 500+ SKUs bleed conversion rate daily because keyword search is terrible at understanding buyer intent. A customer typing 'gift for dad who hikes' gets zero results. IntentParse uses a fine-tuned sentence-transformer model to classify search queries into semantic intent categories derived from the product catalog, then re-ranks results by intent match rather than keyword frequency. Store owners connect their Shopify catalog via API, the system builds a vector index of product descriptions, and a lightweight FastAPI inference endpoint handles live search queries. No GPU server required at launch — runs on a CPU-optimized Hugging Face sentence-transformers model. Buildable in 3 weeks with LangChain for retrieval, Qdrant Cloud for vector storage, and a Shopify webhook for catalog sync.

Why now?

HuggingFace sentence-transformers CPU inference is now fast enough for real-time search re-ranking in April 2026, and Qdrant Cloud's free tier makes vector storage accessible to bootstrapped indie builders for the first time.

▸Automatic vector index built from Shopify product catalog via Admin API sync
▸Semantic intent re-ranking of search results using all-MiniLM-L6-v2 embeddings
▸Zero-result query dashboard showing what customers searched and found nothing
▸Drop-in JavaScript search widget or JSON API endpoint for custom storefronts

Target Audience

Shopify and WooCommerce store owners with 500+ SKUs and measurable search-to-purchase drop-off — roughly 300K stores globally in this segment.

Example Use Case

Sofia runs a 2,000-SKU outdoor gear store and notices 35% of searches return zero results. After installing IntentParse, semantic search drops her zero-result rate to 8% and increases search-initiated purchases by 22% in the first month.

User Stories

▸As a Shopify store owner, I want semantic search to understand buyer intent, so that customers who type natural language queries find relevant products. As an e-commerce operator, I want a zero-result query dashboard, so that I can identify catalog gaps and fix them.
▸As a developer, I want a JSON API endpoint for search results, so that I can integrate semantic search into a custom storefront without replacing my existing UI.

Acceptance Criteria

Catalog Indexing: done when all products are embedded and stored in Qdrant within 5 minutes of install for a 1,000-SKU store. Semantic Search: done when a natural language query returns at least one relevant product for 90% of test queries. Zero-Result Dashboard: done when dashboard shows real query data within 1 hour of first search events. Billing: done when Stripe trial converts and store access is gated correctly at trial expiry.

Is it worth building?

$79/month x 30 stores = $2,370 MRR at month 2. $79/month x 150 stores = $11,850 MRR at month 6. Assumes 6% conversion from 500 Shopify App Store installs per month.

Unit Economics

CAC: $20 via Shopify App Store and Reddit outreach. LTV: $948 (12 months at $79/month). Payback: under 1 month. Gross margin: 85%.

Business Model

SaaS subscription

Monetization Path

14-day free trial, then $79/month per store. High-volume plan at $199/month for 50K+ SKU catalogs.

Revenue Timeline

First dollar: week 3 via trial conversion. $1k MRR: month 2. $5k MRR: month 5. $10k MRR: month 10.

Estimated Monthly Cost

Qdrant Cloud: $35, Fly.io FastAPI hosting: $30, Supabase: $25, Stripe fees: $20, HuggingFace Inference (minimal): $10. Total: ~$120/month at launch.

Profit Potential

Full-time viable at $8k-$15k MRR given low inference cost on CPU-optimized transformer models.

Scalability

High — expand to WooCommerce, BigCommerce, multilingual intent, and personalized re-ranking by purchase history.

Success Metrics

Week 2: 10 beta stores installed. Month 1: 5 paying stores. Month 2: measurable zero-result rate drop reported by 80% of active users.

Launch & Validation Plan

DM 20 Shopify store owners on r/shopify offering free semantic search audit showing their current zero-result query rate before writing inference code.

Customer Acquisition Strategy

First customer: post a zero-result search rate audit tool (free, no code required) on r/shopify and Shopify Partners forum, convert audit users to paid installs. Ongoing: Shopify App Store listing, content marketing on e-commerce CRO blogs, cold email to stores with visible search bars.

What's the competition?

Competition Level

Medium

What's the roadmap?

Feature Roadmap

V1 (launch): catalog vector indexing, semantic search API, zero-result dashboard, JS widget. V2 (month 2-3): WooCommerce support, query analytics, intent category labels. V3 (month 4+): personalized re-ranking, A/B test mode, multilingual embeddings.

Milestone Plan

Phase 1 (Week 1-2): indexer and search endpoint working on test Shopify store, 3 beta stores validate. Phase 2 (Week 3-4): Stripe trial billing live, dashboard ships, Shopify App Store submission. Phase 3 (Month 2): 15 paying stores, zero-result metric improvement documented.

How do you build it?

Tech Stack

FastAPI, sentence-transformers (all-MiniLM-L6-v2), Qdrant Cloud, LangChain retrieval, Shopify Admin API, Next.js dashboard, Supabase, Stripe — build with Cursor for Python backend, v0 for dashboard UI

Suggested Frameworks

HuggingFace sentence-transformers, LangChain, Qdrant Python client

Time to Ship

3 weeks

Required Skills

HuggingFace sentence-transformers, vector database basics, Shopify API, FastAPI deployment.

Resources

HuggingFace sentence-transformers docs, Qdrant Cloud quickstart, Shopify Partner API docs, LangChain retrieval docs.

MVP Scope

main.py (FastAPI), indexer.py (Shopify catalog sync + Qdrant upsert), search.py (semantic retrieval endpoint), dashboard/pages/index.tsx, dashboard/components/ZeroResultsTable.tsx, lib/shopify.ts, lib/stripe.ts, Dockerfile, .env

Core User Journey

Install Shopify app -> catalog auto-indexes in under 5 minutes -> search widget active -> zero-result dashboard shows improvement -> upgrade to paid after trial.

Architecture Pattern

Shopify catalog webhook -> FastAPI indexer -> sentence-transformers encode product descriptions -> Qdrant Cloud vector upsert -> customer search query -> FastAPI semantic search endpoint -> cosine similarity re-rank -> JSON results returned to storefront -> zero-result events logged to Supabase -> dashboard renders analytics.

Data Model

Store has many Products. Product has one Embedding vector in Qdrant. Store has many SearchEvents. SearchEvent has fields query, results_count, and intent_label.

Integration Points

Shopify Admin API for catalog sync, Qdrant Cloud for vector storage and retrieval, HuggingFace sentence-transformers for embeddings, Stripe for billing, Supabase for user and analytics data, Fly.io for FastAPI hosting.

V1 Scope Boundaries

V1 excludes: WooCommerce, personalized re-ranking, multilingual support, A/B testing, analytics beyond zero-result rate.

Success Definition

A Shopify store owner installs IntentParse, sees their zero-result rate drop within 48 hours, and upgrades to paid without any founder support interaction.

Challenges

The hardest non-technical problem is convincing store owners to trust AI search over their existing Shopify setup — requires a clear before/after zero-result rate metric visible within 48 hours of install.

Avoid These Pitfalls

Do not attempt to replace Shopify's native search UI in v1 — offer a JSON API and optional widget to reduce integration friction. Do not store raw customer queries with PII by default. First 10 paying stores require manual outreach to r/shopify and Partner forums — SEO takes 6+ months.

Security Requirements

Supabase Auth for dashboard login, Shopify HMAC webhook verification, RLS on store-scoped data, rate limit 200 req/min per store on search endpoint, anonymize search queries by default for GDPR.

Infrastructure Plan

Fly.io for FastAPI Docker container, Supabase for Postgres and dashboard auth, Qdrant Cloud for vector storage, GitHub Actions for CI/CD, Sentry for Python error tracking, Vercel for Next.js dashboard.

Performance Targets

50 stores at launch with average 500 searches/day each, search endpoint under 300ms p95, dashboard page load under 2s, Qdrant query latency under 100ms.

Go-Live Checklist

☐Security audit complete
☐Shopify HMAC validation tested
☐Stripe trial flow tested end-to-end
☐Sentry live for FastAPI
☐Vercel Analytics configured
☐Custom domain with SSL
☐Privacy policy published
☐3 beta stores signed off
☐Rollback plan documented
☐Shopify App Store listing drafted.

How to build it, step by step

1. Set up FastAPI project with sentence-transformers and qdrant-client installed. 2. Create Shopify Partner app with read_products scope and webhook for product updates. 3. Build indexer.py that fetches all products via Shopify API, encodes descriptions with all-MiniLM-L6-v2, and upserts to Qdrant collection. 4. Build search.py endpoint that encodes incoming query, queries Qdrant top-10, and returns re-ranked product IDs. 5. Log zero-result events to Supabase search_events table. 6. Build Next.js dashboard with zero-result table and install instructions using v0. 7. Add Stripe billing with 14-day trial gated on store SKU count. 8. Package FastAPI as Docker container and deploy to Fly.io. 9. Publish to Shopify App Store with sandbox test store validation. 10. Set up Sentry for FastAPI error tracking and deploy.

Generated

April 2, 2026

Model

claude-sonnet-4-6

← Back to All Ideas