MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
AI candidate screening, resume parsing, outreach emails, bias audits, and interview scheduling.
Texto original del autor
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 0/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 12/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Hiresquire. Sigue https://mcp.popnx.com/i/bp46-hiresquire.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 15 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Hiresquire (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Hiresquire para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "hiresquire": { "command": "uvx", "args": [ "hiresquire" ], "env": { "HIRESQUIRE_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HIRESQUIRE_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Hiresquire aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"hiresquire": {
"command": "uvx",
"args": [
"hiresquire"
],
"env": {
"HIRESQUIRE_API_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Hiresquire y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Hiresquire o muestra una herramienta de Hiresquire en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HIRESQUIRE_BASE_URL Anulación opcional de la URL base de la API (predeterminado: https://hiresquireai.com/api/v1) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Hiresquire
Hiresquire se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Hiresquire
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Hiresquire (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Hiresquire para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user hiresquire --env HIRESQUIRE_API_TOKEN=your-value -- uvx hiresquire 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HIRESQUIRE_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Hiresquire aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user hiresquire --env HIRESQUIRE_API_TOKEN=your-value -- uvx hiresquireCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Hiresquire en la lista como conectado
Usa Hiresquire y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Hiresquire o muestra una herramienta de Hiresquire en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HIRESQUIRE_BASE_URL Anulación opcional de la URL base de la API (predeterminado: https://hiresquireai.com/api/v1) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Hiresquire (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Hiresquire para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "hiresquire": { "command": "uvx", "args": [ "hiresquire" ], "env": { "HIRESQUIRE_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HIRESQUIRE_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Hiresquire aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Hiresquire, HIRESQUIRE_API_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Hiresquire y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Hiresquire o muestra una herramienta de Hiresquire en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HIRESQUIRE_BASE_URL Anulación opcional de la URL base de la API (predeterminado: https://hiresquireai.com/api/v1) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Hiresquire (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Hiresquire para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "hiresquire": { "type": "stdio", "command": "uvx", "args": [ "hiresquire" ], "env": { "HIRESQUIRE_API_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HIRESQUIRE_API_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Hiresquire aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de Hiresquire, HIRESQUIRE_API_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Hiresquire y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Hiresquire o muestra una herramienta de Hiresquire en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HIRESQUIRE_BASE_URL Anulación opcional de la URL base de la API (predeterminado: https://hiresquireai.com/api/v1) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user hiresquire --env HIRESQUIRE_API_TOKEN=your-value -- uvx hiresquireClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"hiresquire": {
"command": "uvx",
"args": [
"hiresquire"
],
"env": {
"HIRESQUIRE_API_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"hiresquire": {
"command": "uvx",
"args": [
"hiresquire"
],
"env": {
"HIRESQUIRE_API_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"hiresquire": {
"type": "stdio",
"command": "uvx",
"args": [
"hiresquire"
],
"env": {
"HIRESQUIRE_API_TOKEN": "your-value"
}
}
}
}HIRESQUIRE_API_TOKEN secreto obligatorio envHIRESQUIRE_BASE_URL envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub bp46, dueña del repo
Último cambio de código: hace 5 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para hiresquire@2.0.2
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/bp46-hiresquire)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: HIRESQUIRE_API_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 5 días, y la última versión (2.0.2) llegó al registro hace 5 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| Este Hiresquire | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Se instala en tu equipo |
| Necesita clave | Sí | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | Sí | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| Licencia | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Unified open-source Python package for HireSquire — AI-powered candidate screening, local resume parsing (PDF, DOCX, TXT, MD), personalized outreach emails, compliance/bias audits, credit management, and interview scheduling.
One install gives you three agent-ready interfaces backed by a single Pydantic v2 schema and resilient HTTP client:
| Surface | Entry Point | Best For |
|---|---|---|
| Python SDK | from hiresquire import HireSquireClient | Python apps, LangChain, AutoGen, CrewAI, custom workflows |
| CLI | hiresquire / uvx hiresquire | Shell agents (Claude Code, OpenClaw, Codex), CI/CD, --json pipelines |
| MCP Server | hiresquire-mcp / hiresquire mcp | Claude Desktop, Cursor, Windsurf, VS Code, any stdio MCP host |
Node.js / TypeScript CLI: Prefer npm? Install
hiresquire-cli(npx hiresquire-cli).
pip install hiresquire
Or run zero-install with uvx:
uvx hiresquire whoami --json
uvx --from hiresquire hiresquire-mcp
pypdf and python-docx are core dependencies — PDF and DOCX parsing work out of the box with no extra flags.
Set your API token (sk_... user token or hs_... spend-limited Agent API key):
export HIRESQUIRE_API_TOKEN="your_token_here"
Or persist it locally (written with mode 0600 to ~/.hiresquire/config.json):
hiresquire init --token YOUR_API_TOKEN
| Environment Variable | Precedence | Description |
|---|---|---|
HIRESQUIRE_API_TOKEN | Highest | API token or Agent API key (hs_...) |
HIRESQUIRE_BASE_URL | Highest | API base URL (default: https://hiresquireai.com/api/v1) |
HIRESQUIRE_WEBHOOK_URL | Highest | Default webhook URL for job completion events |
Precedence order: environment variables > `~/.hiresquire/config.json` > defaults.
Add to claude_desktop_config.json or .mcp.json using uvx (zero manual install):
{
"mcpServers": { "hiresquire": { "command": "uvx", "args": ["--from", "hiresquire", "hiresquire-mcp"], "env": { "HIRESQUIRE_API_TOKEN": "your_token_here" } } } }
Or if installed via pip install hiresquire:
{
"mcpServers": { "hiresquire": { "command": "hiresquire-mcp", "env": { "HIRESQUIRE_API_TOKEN": "your_token_here" } } } }
from hiresquire import HireSquireClient
with HireSquireClient("YOUR_API_TOKEN") as client:
me = client.whoami() print(me"credits")
job = client.jobs.create( title="Senior Python Developer", description="Looking for a backend engineer with 5+ years of Python, FastAPI, and PostgreSQL experience.", resumes=["./resumes/john_doe.pdf", "./resumes/jane_smith.docx"], leniency_level=6, # 1 (lenient) to 10 (strict), default 5 )
results = client.jobs.wait(job["job_id"]) for c in results["candidates"]: print(f"{c['id']}: {c['name']} — {c['score']}/100 | {c['summary']}")
top = results"candidates" email = client.emails.generate( job_id=job["job_id"], candidate_id=top["id"], email_type="invite", tone="professional", ) print(email["subject"], email["body"])
--json ready for agents)# Free token & balance check
hiresquire whoami --json
hiresquire estimate --candidates 25 --json
hiresquire screen \ --title "Senior Python Developer" \ --description "Looking for a backend engineer with 5+ years of Python, FastAPI, and PostgreSQL experience." \ --resumes ./resumes/ \ --leniency 6 \ --watch \ --json
hiresquire results --job 123 --min-score 80 --only-top-n 5 --json
hiresquire email --job 123 --candidate 456 --type invite --tone friendly --json
All MCP tools run locally over stdio via FastMCP, extract resume text locally (never uploading raw binary files), and return structured JSON dicts (including {"error": "...", "message": "..."} on failure rather than crashing).
| Category | Tool | Key Parameters | |||||
|---|---|---|---|---|---|---|---|
| Screening | create_screening | title, description (≥50 chars), resume_paths or resumes, leniency_level (1–10), custom_instructions, webhook_url | |||||
get_screening_status | job_id | ||||||
get_results | job_id, min_score, only_top_n | ||||||
cancel_screening_job | job_id | ||||||
compare_candidates | job_id, candidate_ids (list of ints) | ||||||
report_hiring_outcome | job_id, candidate_id, outcome (hired \ | rejected \ | withdrawn) | ||||
| Outreach | generate_email | job_id, candidate_id, email_type (invite \ | rejection \ | keep-warm \ | followup), tone (professional \ | friendly \ | formal), custom_notes |
bulk_generate_emails | job_id, candidate_ids (max 50), email_type, tone | ||||||
| Credits | get_credit_balance | — | |||||
estimate_screening_cost | candidate_count (1–100) | ||||||
list_credit_packs | — | ||||||
get_credit_transactions | limit, offset | ||||||
purchase_credits | amount or pack (pouch \ | satchel \ | chest), payment_method_id | ||||
create_checkout_session | amount or pack | ||||||
enable_auto_reload | threshold, amount, payment_method_id | ||||||
disable_auto_reload | — | ||||||
| Calendar | list_calendar_connections | — | |||||
create_calendar_connection | provider (calendly \ | calcom), api_key, calendar_id | |||||
get_available_slots | provider, date, duration | ||||||
create_interview | job_id, candidate_id, scheduled_at (ISO 8601), duration_minutes, provider | ||||||
generate_meeting_link | provider, topic, duration | ||||||
| Utilities | whoami | — (free token/balance check) | |||||
get_rate_limit | — | ||||||
test_webhook | url | ||||||
get_api_schema | — | ||||||
audit_screening_job | job_id, selection_threshold (default 70) |
HireSquireClient organizes the API into seven typed namespaces (all validated with Pydantic v2 models in hiresquire.models):
create(), create_from_zip(), list(), get_status(), get_results(), wait(), cancel(), compare(), report_outcome()get(), update_status()generate(), bulk_generate(), generate_questions(), generate_icebreaker()get_balance(), estimate_cost(), list_packs(), get_transactions(), purchase(), create_checkout_session(), create_payment_intent(), enable_auto_reload(), disable_auto_reload()list(), connect(), get_slots(), create_interview(), generate_meeting_link()list(), create(), get(), update(), revoke(), regenerate(), get_usage()whoami(), get_rate_limit(), test_webhook(), get_api_schema(), audit_screening_job()POST /api/v1/jobs){
"title": "Senior Python Developer", "description": "Minimum 50 characters describing role requirements and stack.", "resumes": [ { "filename": "ada_lovelace.pdf", "content": "Extracted resume text..." } ], "leniency_level": 5, "custom_instructions": "Prioritize distributed systems experience", "webhook_url": "https://example.com/webhooks/hiresquire" }
Idempotency-Key (UUID v4) is auto-generated and sent as an HTTP header on jobs.create, jobs.create_from_zip, and credits.purchase so retries never double-charge.leniency_level: integer 1 (most lenient) to 10 (strictest), default 5..txt, .md, .pdf, .docx; max 20 MB per file, max 100 resumes per batch, minimum 50 characters of extracted text.GET /api/v1/jobs/{id}/results){
"job_id": 42, "job_title": "Senior Python Developer", "status": "completed", "total_candidates": 1, "candidates": [ { "id": 101, "name": "Ada Lovelace", "email": "ada@example.com", "score": 94, "summary": "Strong distributed systems and Python background.", "strengths": ["10+ years Python", "Event-driven architecture"], "weaknesses": ["Limited Kubernetes exposure"], "skills": ["Python", "PostgreSQL", "FastAPI"], "status": "new" } ], "agent_summary": "1 strong match identified..." }
hiresquire.errors)| HTTP Status | Exception Class | Code | Notes |
|---|---|---|---|
401 / 403 | AuthenticationError | AUTHENTICATION_ERROR | Missing/invalid token or forbidden job |
402 | PaymentRequiredError | PAYMENT_REQUIRED | Insufficient credits or agent spend limit reached |
404 | NotFoundError | NOT_FOUND | Job, candidate, or key not found |
400 / 422 | ValidationError | VALIDATION_ERROR | Invalid payload (e.g., description < 50 chars) |
429 | RateLimitError | RATE_LIMIT_ERROR | Automatically retried honoring Retry-After |
Pass --json to any command for clean machine-readable output:
hiresquire init Save token & defaults to ~/.hiresquire/config.json (0600)
hiresquire configure Update or --clear saved configuration hiresquire whoami Verify token and check credit balance (free) hiresquire estimate Estimate cost for N candidates hiresquire screen Submit resumes (--resumes or --zip, --watch, --leniency) hiresquire jobs List screening jobs (--status, --page, --limit) hiresquire status Check or --watch job status hiresquire results Fetch ranked candidates (--min-score, --only-top-n) hiresquire summary Display AI summary for a completed job hiresquire compare Compare candidates side-by-side hiresquire cancel Cancel a processing job hiresquire outcome Report hiring outcome (hired | rejected | withdrawn) hiresquire candidate Get candidate details hiresquire set-status Update candidate status hiresquire email Generate outreach email (--type, --tone, --message) hiresquire credits ... balance | list-packs | checkout | purchase | transactions | auto-reload-enable | auto-reload-disable hiresquire agent-keys ... list | create | get | update | revoke | regenerate | usage hiresquire calendar ... connect | list (also calendar:connect, calendar:list) hiresquire interviews ... schedule | list (also interviews:schedule, interviews:list) hiresquire meetings link Generate meeting link (also meetings:link) hiresquire rate-limit Check API rate limit status hiresquire webhook-tes