Skip to content

docs: clarify OpenRole mission and search intent #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sarvanithin merged 1 commit into from
Sep 2, 2026
Merged

docs: clarify OpenRole mission and search intent #1

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 24 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,20 +4,37 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-3776AB.svg)](https://www.python.org/)

**Open-source job intelligence for verified U.S. openings and explainable H-1B
sponsorship evidence.**
**Open-source job intelligence for verified U.S. job openings and explainable
H-1B visa-sponsorship evidence.**

OpenRole replaces spreadsheet-based job tracking with a transparent, local-first
pipeline: verified employer sources, complete-manifest ingestion, U.S.-only public
results, job freshness tracking, and evidence users can inspect. It is the next
iteration of Fortune Job Scraper, designed to be useful to job seekers and safe to
extend in public.
OpenRole Intelligence helps U.S. job seekers find current roles directly from
employer career sites and understand the sponsorship language in each posting. It
replaces spreadsheet-based job tracking with a transparent, local-first pipeline:
verified employer sources, complete-manifest ingestion, U.S.-only results, job
freshness tracking, and evidence users can inspect. It is the next iteration of
Fortune Job Scraper, designed to be useful to job seekers and safe to extend in
public.

> **No black-box sponsorship claims.** A Tier A result means the current job posting
> contains an explicit, job-specific immigration sponsorship offer. A current posting
> that denies sponsorship is Tier E and overrides employer history. Ambiguous or
> conditional wording is not promoted to Tier A.

## Our mission

Finding an employer-sponsored role should not require trusting a black-box job
board or a stale spreadsheet. OpenRole is building a public, evidence-first index
where every result answers three practical questions:

1. **Is this role open in the United States right now?**
2. **Which employer-controlled source did it come from?**
3. **What does the current posting actually say about sponsorship?**

We want contributors to help make that index broader and more trustworthy: add a
documented ATS connector, report an official career page, improve location or
evidence rules, or make the product more accessible. Start with
[CONTRIBUTING.md](CONTRIBUTING.md) and the public [roadmap](ROADMAP.md).

## Why OpenRole?

- **Verified sources, not guessed URLs.** Sources are registered, policy-reviewed,
Expand Down
Loading