Full-Stack/API Developer Needed — AI Physician Authority Scanner MVP

# Full-Stack/API Developer Needed — AI Physician Authority Scanner MVP ## Project Overview I own a video marketing company focused specifically on physicians, and I am building an internal tool called a **Physician Authority Scanner**. The goal is simple: I enter a physician's: * Name * Specialty * City * Website The tool automatically analyzes the physician's digital presence across search, website content, video, social media, reviews, and competitors, then produces a structured **Physician Authority Score**. I already have the scoring methodology, API accounts, data structure, and detailed product documentation. I am NOT looking to build a polished SaaS application yet. The first goal is to build a **working internal MVP/proof of concept** that I can test on approximately 5–20 physicians. --- # What the Tool Needs to Analyze ## 1. Google Search Presence Analyze relevant Google searches around the physician's: * Specialty * Procedures * Conditions treated * Location * Name We want to understand how visible the physician is when patients search for their expertise. --- ## 2. Google Maps & Reputation Collect information such as: * Maps/local presence * Rating * Review volume * Review recency * Relevant competitor comparisons --- ## 3. Physician Website Crawl the physician's website and identify: * Physician bio * Conditions treated * Procedures * Patient education * FAQs * Blog/resources * Relevant educational content The system should determine how well the physician answers important patient questions online. --- # 4. Patient Question Analysis The system should create approximately **20–30 important patient questions** based on the physician's specialty, procedures, website, and search data. Example: For a foot/ankle surgeon: * Do I need bunion surgery? * How long is bunion surgery recovery? * Can bunions be treated without surgery? * When can I walk after surgery? The system should then determine which questions the physician currently answers through their website, video, and social content. --- # 5. YouTube Presence Identify the physician's YouTube presence where possible and analyze: * Educational videos * Publishing activity * Topics covered * Physician-led videos * Patient-question coverage * Search visibility --- # 6. Instagram Presence Identify the physician's professional Instagram presence where reliably available. We are interested in signals such as: * Is there a professional account? * Is the account active? * Is the physician appearing in video? * How much content is educational versus promotional? * What medical topics are being discussed? * Publishing consistency * Patient-question/topic coverage I do NOT want follower count to be the primary measurement. The goal is to evaluate whether the physician is actually using Instagram to demonstrate expertise. --- # 7. LinkedIn Presence Identify the physician's professional LinkedIn presence where publicly and compliantly accessible. Possible signals include: * Profile presence * Professional positioning * Specialty/expertise consistency * Recent thought-leadership/content presence * Physician-authored educational content I understand LinkedIn's official API/public-data access may be more restrictive than other platforms. I want the developer to build this portion using compliant, maintainable methods and gracefully mark unavailable information as **unknown** rather than inventing or forcing data. --- # 8. Competitor / Market Comparison The system should identify approximately **5 relevant physicians** in the same specialty/market. We want basic comparisons such as: * Search visibility * Review presence * Website educational content * YouTube/video presence * Social/content activity The first version does NOT need to perform an extremely expensive full analysis of every competitor. --- # 9. Authority Scoring I already have a scoring methodology. The Authority Score will include areas such as: * Search Authority * Reputation Authority * Educational Authority * Video & Social Authority * Website Authority AI should NOT simply decide: "This physician deserves a score of 73." AI will be used for structured tasks such as: * Classifying website pages * Identifying educational content * Matching content with patient questions * Classifying videos/social content * Topic clustering * Determining whether content is physician-led * Identifying content gaps The final Authority Score should be calculated using predefined scoring rules/formulas. --- # Important Data Rule The system must distinguish between: ### Confirmed Missing Example: We verified that the physician does not have a YouTube channel. and: ### Unknown Example: The system could not confidently determine which YouTube channel belongs to the physician. Unknown information should NOT automatically become a zero. --- # API / Technology Accounts Already Available I have already created accounts for: * DataForSEO * Firecrawl * OpenAI API * YouTube Data API * Google Cloud * PageSpeed Insights * Supabase * GitHub I am open to recommendations for Instagram/LinkedIn data acquisition, but I do not want unnecessary expensive SaaS subscriptions added without a good reason. --- # What I Need Built First I need a simple internal interface. ### Input Doctor Name: Specialty: City: Website: ### RUN SCAN The system then performs the research automatically. --- # Example Output ## Dr. Example ### Physician Authority Score **67 / 100** ### Search Authority 72 ### Reputation Authority 81 ### Educational Authority 49 ### Video & Social Authority 38 ### Website Authority 77 --- ## Patient Education Coverage **12 of 30 important patient questions answered** 18 opportunities identified. --- ## Video & Social Presence YouTube: 14 educational videos identified Instagram: Active account; educational presence detected LinkedIn: Professional presence identified --- ## Market Comparison Your Position: **#4 of 6 physicians analyzed** --- ## Biggest Authority Opportunity **Patient Education Video** 18 important patient questions currently have no meaningful physician-led video answer identified. --- # Evidence I also need an internal way to inspect the underlying data that produced the results. For example: * Search query * Ranking * Page URL * Video URL * Social profile * Review data * Source * Classification * Confidence It does NOT need to be a beautiful interface initially. Accuracy and reliability are more important. --- # Preferred Technology I am open to recommendations. A possible stack could include: * Python / FastAPI * TypeScript / Next.js * Supabase / PostgreSQL * OpenAI API * DataForSEO * Firecrawl I care more about clean architecture than a specific framework. --- # Project Ownership All code must be committed to a private GitHub repository owned by my company. API accounts remain under my ownership. API keys must never be hard-coded into the application or committed to GitHub. --- # MVP Scope This project is specifically for the **internal proof of concept**. I do NOT currently need: * Customer login system * Billing * Stripe * Mobile app * Complex admin dashboard * CRM integration * Automated email campaigns * Advanced client dashboard * Highly polished UI * Enterprise-scale infrastructure If the MVP works well, I intend to continue development into a polished public-facing product. --- # Budget **$1,000–$2,000 fixed price for the initial MVP** I prefer milestone-based development. There is potential for additional work if the prototype performs well. --- # Developer Requirements I am looking for someone strong in: * API integration * Python and/or TypeScript * OpenAI API * Structured AI outputs / JSON * Supabase/PostgreSQL * Data collection * Web crawling * API error handling * Data normalization * Scoring systems SEO/search-data experience is a major plus. Experience with Instagram or LinkedIn data integrations is also helpful. Healthcare experience is NOT required. --- # Please Answer These Questions ### 1. Tell me about a project where you combined several APIs/data sources into one application. ### 2. How would you build this so that one API failing does not cause the physician to incorrectly receive a zero? ### 3. How would you structure the OpenAI portion so AI classifies the information but does not arbitrarily control the score? ### 4. Have you worked with: DataForSEO, Firecrawl, Supabase, OpenAI API, YouTube Data API, Instagram APIs/data, or LinkedIn APIs/data? Please specify which. ### 5. What would you recommend for reliably analyzing public Instagram and LinkedIn presence while remaining compliant with platform restrictions? ### 6. What technology stack would you use for this MVP? ### 7. Can you complete the work inside a GitHub repository that I own? 8. Will you personally build the project, or will it be delegated? 9. Please provide 1–3 examples of technically similar projects you have built. 10. Please begin your proposal with: PHYSICIAN AUTHORITY so I know you read the complete project description. I have detailed technical specifications, scoring methodology, and data contracts available for the developer selected for the project.