Skip to content

guruprashanth2004/jobscope-ai-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JobScope AI Agent

JobScope AI Agent is a Python web application that researches companies and job roles using Google Search, Google News, and Google Jobs (via SerpAPI). It summarizes company information, latest news, and job insights, presenting them in a user-friendly web interface.


Features

  • Company Overview: Fetches company summary, headquarters, founding date, employee count, and website.
  • Latest News: Retrieves recent news headlines about the company.
  • Role Insights: Extracts key skills, experience requirements, salary estimates, and sample job postings for a given role at the company.
  • Web Interface: Simple Flask-based UI for entering company and role, and viewing results.
  • API Key Security: Uses a .env file to securely store API keys.

Setup

1. Clone the Repository

git clone https://github.com/guruprashanth2004/jobscope-ai-agent.git
cd jobscope-ai-agent

2. Install Dependencies

pip install -r requirements.txt

3. Configure API Keys

Create a .env file in the project root with your SerpAPI key (and others if needed):

SERPAPI_KEY=your_serpapi_key_here

You can get a free SerpAPI key at serpapi.com.


Usage

Run as a Web App

python web_app.py

Run from Command Line

python research_agent_full.py --company "NVIDIA" --role "Software Engineer" --out nv_se_report.json
  • This will print the results and save them to nv_se_report.json.

Project Structure

jobscope-ai-agent/
│
├── research_agent_full.py   # Core logic for fetching and summarizing data
├── web_app.py               # Flask web interface
├── requirements.txt         # Python dependencies
├── .env                     # API keys (not committed)
├── templates/
│   ├── index.html           # Home/search page
│   └── result.html          # Results display page
└── ...

Notes

  • API Usage: This app uses SerpAPI, which may have usage limits on free plans.
  • Security: Never commit your .env file or API keys to public repositories.
  • Extensibility: You can add more data sources or enhance summaries by extending research_agent_full.py.

License

MIT License


Credits

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published