Inspiration
Entrepreneurs often ask a simple but high-stakes question: “Would this business work in this neighborhood?” Today, answering that means scanning Yelp listings, reading endless reviews, and guessing about market gaps. We built Business Opportunity Finder to turn all of that into instant, structured insight by combining Yelp’s real-world data with Gemini’s analytical reasoning.
What it does
Business Opportunity Finder uses Yelp Fusion data and Google Gemini to analyze local competitors and reveal market gaps. The app identifies top competitors, evaluates their weaknesses across criteria like Service Speed, Price Fairness, Product Quality, Ambiance, and Reliability, and visualizes the results in a Competitor Weakness Heatmap. It also generates Customer Personas and Review Themes from real reviews, giving founders a clear snapshot of both the competitive landscape and the customers they’d serve — all from a single natural-language question.
How we built it
The backend is a lightweight Node.js + Express service that loads YELP_API_KEY and GEMINI_API_KEY from .env, fetches nearby business data from Yelp Fusion, and forwards structured inputs plus the user’s question to Gemini. Gemini then returns a clean JSON payload containing the market analysis, competitor scores, personas, and review insights. The frontend, built with vanilla HTML/CSS/JS, renders the heatmap, summary, personas, and review breakdown in a dynamic, easy-to-read layout.
Challenges we ran into
Yelp’s data was straightforward to fetch — the real challenge was orchestrating how Gemini interprets and restructures that data into consistent, actionable insight. We had to design a careful prompt schema that blends Yelp’s deterministic business information with Gemini’s generative reasoning to produce stable JSON for the heatmap, coherent competitor scoring, and personas that accurately reflect review patterns. Creating this synthesis layer — not the data retrieval — was the hardest and most important part.
Accomplishments that we're proud of
We built a fully functional decision-support tool powered by real Yelp data and real AI reasoning. The Heatmap immediately highlights competitor weaknesses, the Customer Personas feel grounded in authentic reviews, and the Market Summary reads like a professional analyst’s report. The most satisfying part is that users can type any business question and instantly get a usable, data-informed answer.
What we learned
We learned how to merge deterministic datasets with generative AI to create structured insight, how to design strict JSON-bound prompts, and how to guide Gemini to produce stable, multi-part analysis from complex inputs. We also learned that simple frontend design can be extremely effective when the underlying intelligence is strong.
What’s next for Business Opportunity Finder
Next steps include neighborhood-to-neighborhood comparisons, dynamic scoring criteria based on review patterns, exporting full opportunity reports, and adding trend detection over time. Ultimately, this could evolve into a full AI-powered market validation platform for founders, franchise operators, and real estate site selectors.

Log in or sign up for Devpost to join the conversation.