AI-powered vendor screening and company evaluation tool
Features • Installation • Usage • Documentation • Contributing
IT Park Company Scoring is a desktop application that transforms subjective vendor screening into a consistent, evidence-based evaluation process. By leveraging AI and public web data, it provides comprehensive company scorecards to support informed business decisions.
- 🔍 Automated Data Collection - Gathers public information from company websites, review platforms, job boards, and news sources
- 📊 AI-Powered Scoring - Evaluates companies using a structured rubric with coverage and confidence metrics
- 📄 Multi-Format Reports - Exports detailed scorecards as PDF, CSV, and Excel files
- 🎯 Customizable Criteria - Select evaluation criteria by category to match your needs
- 💾 Local Caching - Stores public pages locally for transparency and auditability
- 🚫 Smart Filtering - Automatically disqualifies companies with insufficient public information or no English support
- ❌ No Unauthorized Scraping - Respects site policies; doesn't access LinkedIn, Apollo, or other restricted platforms
- ❌ No Data Storage - API keys are held in memory only and cleared on exit
- ❌ No Private Data - Only uses publicly available information
This tool emerged from a real-world need identified during my internship with the IT Park regional project management department. We were manually evaluating international businesses for outsourcing opportunities through subjective browsing of various platforms—a process that was:
- ⏰ Time-consuming and inconsistent
- 🎲 Subjective with varying quality
- 📉 Difficult to compare across evaluators
I built this application to replace that manual process with a systematic, reproducible, and data-driven approach.
🎉 Currently in Active Use: The tool is actively deployed in the IT Park regional project management department for vendor screening operations.
| Feature | Description |
|---|---|
| 🔄 Flexible Criteria Selection | Choose evaluation criteria by category to customize your assessment |
| 📈 Float-Based Scoring | Precise numerical scores with coverage and confidence indicators |
| 🤖 AI-Powered Analysis | Leverages OpenAI's language models for intelligent evaluation |
| 📦 Multiple Export Formats | Generate reports in PDF, CSV, and Excel formats |
| 🗄️ SQLite Caching | Local database for storing and auditing collected data |
| 🌐 Public Data Only | Respects robots.txt and website terms of service |
| 🖥️ Desktop Interface | User-friendly GUI built with PySide6 |
| 🔒 Privacy-First | No API key storage; all credentials held in memory only |
- Coverage Metrics: Measures how much relevant data was available
- Confidence Scores: Indicates reliability of the assessment
- Structured Rubric: Consistent evaluation framework across all companies
- Automatic Disqualification: Filters out companies with insufficient data
| Category | Technologies |
|---|---|
| Language |  Python 3.10+ |
| GUI Framework |  PySide6 |
| Web Scraping | Requests • BeautifulSoup4 • lxml |
| AI/LLM |  OpenAI API |
| Database |  SQLite |
| Export | ReportLab (PDF) • pandas (Excel/CSV) |
- Python 3.10 or higher
- pip (Python package manager)
- OpenAI API key (Get one here)
# Clone the repository
git clone https://github.com/yourusername/itpark-scoring.git
cd itpark-scoring
# Create virtual environment
python -m venv .venv
# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate
# Install in development mode
pip install -e .
# Run the application
python -m itpark_scoring.app- Download
itpark-scoring.exefrom the Releases page - Double-click the executable to launch
- No installation required!
# Install the package
pip install itpark-scoring
# Run the application
python -m itpark_scoring.app-
Launch the Application
python -m itpark_scoring.app
-
Enter API Key
- Paste your OpenAI API key in the designated field
- The key is stored in memory only and cleared on exit
-
Configure Evaluation
- Select the criteria categories you want to evaluate
- Customize the scoring parameters if needed
-
Run Analysis
- Enter the company name
- Click "Analyze" to start the evaluation
- Wait for the data collection and AI analysis to complete
-
Export Results
- Choose your preferred format (PDF, CSV, Excel)
- Save the report to your desired location
Company Name: "Acme Corporation"
Selected Criteria: ✓ Financial Stability
✓ Technical Capability
✓ Client Reviews
→ Data Collection (30-60 seconds)
→ AI Analysis (15-30 seconds)
→ Report Generated ✓
Output: acme_corporation_scorecard.pdf
Security Notes:
- 🔒 API keys are never stored on disk
- 💾 Keys are held in memory only during the session
- 🗑️ Keys are automatically cleared when the application closes
You can customize which criteria are included in the evaluation:
- Company Profile: Basic information, industry, size
- Financial Stability: Revenue, funding, growth indicators
- Technical Capability: Technology stack, certifications, expertise
- Client Reviews: Ratings, testimonials, case studies
- Market Presence: News mentions, social media, thought leadership
- Team Quality: Job postings, employee reviews, team size
The tool collects information from:
- ✅ Company websites (public pages)
- ✅ Review platforms (Clutch, G2, etc.)
- ✅ Job boards (public listings)
- ✅ News sites and press releases
- ✅ Search engine results
| Aspect | Our Approach |
|---|---|
| robots.txt | Fully respected; disallowed pages are skipped |
| Rate Limiting | Implemented to avoid overwhelming servers |
| Terms of Service | Users should review target sites' ToS |
| Data Privacy | Only public information is collected |
| Attribution | Source URLs are preserved in reports |
The following platforms are NOT accessed due to their terms of service:
- ❌ LinkedIn (requires authorization)
- ❌ Apollo.io (subscription service)
- ❌ Private databases or paywalled content
- ❌ Any site that explicitly prohibits automated access
💡 Tip: For data from restricted sources, consider manual input or approved API integrations.
- Professional formatting with headers and footers
- Charts and visualizations
- Detailed scoring breakdowns
- Source citations
- Structured data for analysis
- Compatible with Excel and Google Sheets
- Easy to import into databases
- Multiple sheets for different sections
- Formatted tables and conditional formatting
- Ready for presentation
- 🔌 API Integration - Add approved data sources via official APIs
- 🌍 Regional Weighting - Preset scoring weights for different markets
- ⚖️ Side-by-Side Comparison - Compare multiple companies simultaneously
- 📊 Historical Tracking - Track company scores over time
- 🎨 Custom Templates - User-defined report templates
- 🔔 Notification System - Alerts for scoring changes
- 📱 Web Dashboard - Browser-based interface option
- 🤝 Team Collaboration - Shared evaluations and comments
This project is licensed under the MIT License - see the LICENSE file for details.
Q: Do I need to pay for the OpenAI API?
A: Yes, you'll need an OpenAI API account. Pricing varies based on usage.
Q: Can I use this for commercial purposes?
A: Yes! The MIT license allows commercial use.
Q: How long does an analysis take?
A: Typically 1-2 minutes per company, depending on data availability.
Q: Is my data secure?
A: Yes. API keys are not stored, and all data remains local.
This tool provides decision support based on publicly available information. Always validate critical business decisions with:
- ✅ Human review and expertise
- ✅ Direct company contact
- ✅ Legal and financial advisors
- ✅ Multiple data sources
The scores and assessments are meant to augment, not replace, professional judgment.
- IT Park Regional Project Management Department - For the opportunity and real-world testing
- OpenAI - For providing the AI capabilities
- Open Source Community - For the amazing libraries and tools