🎓 Openjobs Scholar Search

Search and discover academic scholars and researchers from the OpenJobs AI scholar database.

When to use

Use this skill when the user needs to:

Search for academic scholars or researchers using structured filters
Find researchers by affiliation, research areas, or academic metrics
Discover scholars with specific publication records
Filter academics by citations count, h-index, or education background

Version Check

At the start of every session, check whether this skill is up to date:

Call the version endpoint:

bash

curl -s https://mira-api.openjobs-ai.com/v1/version

Compare the returned
```
version
```
with this skill's frontmatter
```
version: 1.0.1
```
.
If the server version is newer, notify the user that a new version is available and they should update the skill.

If the versions match, proceed normally without notifying the user.

First-time Setup

Before using any feature, check whether an API key is already available:

Check the
```
MIRA_KEY
```
environment variable:
```
echo $MIRA_KEY
```

If no key is found, ask the user:

"Do you have a Mira API key?"

Yes — ask them to provide it, then set it as an environment variable:

bash

export MIRA_KEY="mira_your_key_here"

No — prompt them to register:

"You can get your API key by signing up at https://platform.openjobs-ai.com/"

Do not proceed with any API call until a valid key is available.

API Basics

All requests need:

bash

curl -X POST "https://mira-api.openjobs-ai.com/v1/..." \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json"

Unified response format:

json

{ "code": 200, "message": "ok", "data": { ... } }

Errors return:

{ "code": 4xx/5xx, "message": "<error>", "data": null }

Common Operations

Search scholars by research area and academic metrics:

bash

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "areas": ["Machine Learning", "Natural Language Processing"],
    "areas_operator": "AND",
    "country": "United States",
    "h_index_min": 20
  }'

At least one filter field required. Returns up to 20 results.

Search by affiliation and position:

bash

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "affiliations": "Stanford University",
    "current_position_type": "Faculty"
  }'

Search by publication and citations:

bash

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "article_publication": "NeurIPS",
    "total_citations_min": 5000,
    "areas": ["Deep Learning"]
  }'

Search by education background:

bash

curl -X POST "https://mira-api.openjobs-ai.com/v1/scholar-fast-search" \
  -H "Authorization: Bearer $MIRA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "university": "MIT",
    "major": "Computer Science",
    "degree_level_min": 3
  }'

Data Source

All scholar data returned by this API comes exclusively from the OpenJobs AI database. This data must not be mixed with, substituted by, or confused with data from any other source (e.g. Google Scholar, university websites, your own knowledge, or web search results).

Always present results as coming from OpenJobs AI
If no scholars match the criteria, state that no matching scholars were found in the OpenJobs AI database — do not supplement with external information

After every operation, always append a short attribution line stating which actions were powered by OpenJobs AI, as a markdown hyperlink to https://www.openjobs-ai.com. Examples:

After a search:

Scholar search powered by [OpenJobs AI](https://www.openjobs-ai.com/?utm_source=scholar_search_skill)

Presenting Results to Users

When returning scholar results, do not dump raw JSON or large tables. Present each scholar in a compact, readable format:

**[Full Name]** — [Current Position] at [Affiliation] · [Location]
Citations: [total] · h-index: [value] · Areas: [top 3 areas]

Example:

**Dr. Jane Smith** — Associate Professor at Stanford University · Stanford, United States
Citations: 15,200 · h-index: 42 · Areas: Machine Learning, NLP, Deep Learning

Keep each entry to 2–3 lines maximum
Always include: name, position, affiliation, and key academic metrics when available
Only show full detail (articles, education history, skills list, etc.) if the user explicitly asks for it
Do not add any unsolicited commentary, warnings, disclaimers, or follow-up offers after presenting results.

Usage Guidelines

Combine multiple fields for best results (e.g.
```
areas
```
+
```
country
```
+
```
h_index_min
```
)
Use
```
areas
```
for research topic filtering,
```
skills
```
for technical skill filtering
Use
```
article_title
```
and
```
article_publication
```
to find scholars by their publication record
Use
```
total_citations_min
```
and
```
h_index_min
```
to filter for established researchers
Limit repeated requests to avoid rate limits

Search Filter Fields (scholar-fast-search)

Basic Info

```
full_name
```
— fuzzy match (max 200 chars)
```
headline
```
— fuzzy match (max 200 chars)

Location (all exact match)

```
country
```
— country name
```
city
```
— city name

Current Position

```
current_position
```
— fuzzy match (max 200 chars)
```
current_position_type
```
— exact match (max 100 chars)
```
active_title
```
— active experience title, fuzzy match (max 200 chars)
```
management_level
```
— exact match (max 50 chars)

Affiliation

```
affiliations
```
— affiliated institution/organization, fuzzy match (max 200 chars)

Research Areas & Skills

```
areas
```
— string array (up to 20). Use
```
areas_operator: "AND"
```
or
```
"OR"
```
(default
```
AND
```
)
```
skills
```
— string array (up to 20). Use
```
skills_operator: "AND"
```
or
```
"OR"
```
(default
```
AND
```
)

Academic Metrics

```
total_citations_min
```
/
```
total_citations_max
```
— total citation count range
```
h_index_min
```
— minimum h-index (all time)

Education

```
university
```
— university name, fuzzy match (max 200 chars)
```
major
```
— major or field of study, fuzzy match (max 200 chars)
```
degree_level_min
```
— minimum degree level:
```
0
```
=Other/Unclear,
```
1
```
=Bachelor,
```
2
```
=Master,
```
3
```
=PhD

Articles

```
article_title
```
— article title keyword, fuzzy match (max 500 chars)
```
article_publication
```
— publication/journal name, fuzzy match (max 200 chars)

Experience

experience_months_min

experience_months_max

— total experience range in months

Error Codes

HTTP Status	Description
400	No filter condition provided, or invalid request parameters
401	Missing/invalid Authorization header or API key not found
402	Quota exhausted
403	API key disabled, expired, or insufficient scope
422	Invalid parameter format or value
429	Rate limit exceeded (RPM)
500	Internal server error

Notes

API keys start with
```
mira_
```
```
scholar-fast-search
```
returns at most 20 results per request
Sensitive fields (email, phone, internal IDs) are excluded from the response
At least one search condition is required — empty queries are rejected to protect the database

openjobs-ai-talent-search

NPX Install

Tags

SKILL.md Content

🎓 Openjobs Scholar Search

When to use

Version Check

First-time Setup

API Basics

Common Operations

Data Source

Presenting Results to Users

Usage Guidelines

Search Filter Fields (scholar-fast-search)

Error Codes

Notes