tddagoat7-afk/adwumatech-ai-ghana-V5

# AdwumaTech AI Ghana Dashboard v5 A more detailed, evidence-first Ghana company media-intelligence dashboard. ## Run it 1. Install Node.js 18 or newer. 2. Open Terminal in this folder. 3. Run: ```bash npm start ``` 4. Open `localhost` Do not open `public/index.html` directly. The server is required for reliable live searches. ## Live features - Search any Ghana company, SME, startup, bank, nonprofit, product brand, or trading name. - Up to 250 current public-news results from GDELT DOC 2.0. - Deduplication by publisher and normalized title. - Mention timeline. - Positive, neutral, and negative headline signals. - Reputation score, momentum, unique-source count, confidence estimate. - Top publishers and source geography. - Filterable evidence table with direct source links. - CSV evidence export. ## Important limits “Any company” means the user can enter any name; it does not guarantee that public coverage exists. Smaller businesses may return zero results. The official Ghana ORC site should be used to verify registration/name availability. A lawful production service needs separate licensed or authorized connectors for: - Meta, TikTok, YouTube, X, LinkedIn and other social platforms. - Ghana radio and TV audio streams plus speech-to-text. - Podcast feeds and transcripts. The dashboard never invents data for unavailable channels. ## Data methodology The backend searches GDELT for the exact company phrase plus `Ghana`, normalizes article metadata, removes likely duplicates, and classifies headline wording with an explainable keyword method. This is a directional signal and requires human review. ## Improved company discovery in v3 The backend now automatically tries: - The exact company name plus Ghana. - A broader unquoted company-name search plus Ghana. - A shortened version with terms such as Ltd, Limited, PLC, Company, and Ghana removed. - Relevance ranking that favors exact names, matching brand tokens, Ghanaian sources, and Ghana re …