How soloiaros/archies-appstore-lookup works
10K / App Store Indexor turns natural-language queries into factual, comparative, or scored discovery results from an indexed catalog of Apple listings. The main workflow runs from the search UI through the query API and router to retrieval, optional Jev scoring, and rendered results; factual detail and comparative momentum are separate branches. A second product workflow grows the catalog from chart and Lookup feeds, then enriches it with embeddings, visual signals, and estimates. The README documents these capabilities; unsampled implementation details and some subsystem wiring are therefore shown only where documented.
Main entry points: router/index.ts Query router · store.ts Catalog storage · detail.ts App details · scrape/index.ts Catalog ingestion
Components 24
Search and answers
- Query endpoint
app/api/query/route.ts - Query router
lib/router/index.ts - Query classification
lib/router/classify.ts - Factual lookup
lib/router/factual.ts - Comparative ranking
lib/router/comparative.ts - Discovery retrieval
lib/retrieve/finalists.ts - Jev scoring
lib/jev/score.ts
Catalog and enrichment
- Catalog access
lib/catalog/cloud.ts - App details
lib/catalog/detail.ts - Provenance rules
models/provenance.ts - Catalog ingestion
lib/scrape/index.ts - Catalog storage
lib/scrape/store.ts - Offline enrichment
lib/pipeline/embed.ts
Account and site services
- Site endpoints
app/api/collect/route.ts - Site services
lib/site/stats.ts - Site database
lib/site/db.ts
Product experience
- Search interface
components/QueryScreen.tsx - Query state
hooks/useQuery.ts - Home and icon scene
app/page.tsx - Vending icon endpoints
app/api/vending-icons/route.ts
Other components
- Researcher
- Apple chart feeds
- Apple Lookup API
- OpenRouter
Connections 24
- Researcher → Search interface: enters query
- Search interface → Query state: submits query
components/QueryScreen.tsx - Query state → Query endpoint: posts query
hooks/useQuery.ts - Query endpoint → Query router: dispatches query
app/api/query/route.ts - Query router → Query classification: classifies shape
lib/router/index.ts - Query router → Factual lookup: routes factual
lib/router/index.ts - Query router → Comparative ranking: routes comparative
lib/router/index.ts - Query router → Discovery retrieval: routes local discovery
lib/router/index.ts - Query router → Catalog access: selects catalog
lib/router/index.ts - Catalog access → Discovery retrieval: retrieves finalists
- Query router → Jev scoring: scores finalists
lib/router/index.ts - Jev scoring → OpenRouter: requests scoring
- Query router → App details: loads app detail
- App details → Catalog storage: reads app records
lib/catalog/detail.ts - App details → Provenance rules: returns tiered fields
lib/catalog/detail.ts - Apple chart feeds → Catalog ingestion: provides chart data
- Apple Lookup API → Catalog ingestion: provides listings
- Catalog ingestion → Catalog storage: writes catalog
- Catalog storage → Offline enrichment: supplies app data
- Offline enrichment → Catalog storage: stores signals
- Site endpoints → Site services: records visits
app/api/collect/route.ts - Site services → Site database: reads and writes
lib/site/stats.ts - Home and icon scene → Researcher: introduces product
app/page.tsx - Vending icon endpoints → Catalog storage: serves catalog icons
app/api/vending-icons/route.ts