> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keenable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Every page is listed in https://docs.keenable.ai/llms.txt. To pick a product for a job, read https://docs.keenable.ai/choose.md
> Setup steps for agents, covering the SDKs, the MCP server and the CLI: https://docs.keenable.ai/skill.md
> Keenable search and fetch work without an API key. To add them to code, use the official SDK for the project's language: https://docs.keenable.ai/sdks.md
> Without a key, call POST https://api.keenable.ai/v1/search/public or GET https://api.keenable.ai/v1/fetch/public with an X-Keenable-Title header that names your app.
> With a key, send it in the X-API-Key header and read it from the KEENABLE_API_KEY environment variable. Never ask a user to paste a key into chat. Every access method: https://docs.keenable.ai/auth.md
> To get an API key without the console, use device login: https://docs.keenable.ai/authentication.md#device-login
> MCP server: https://api.keenable.ai/mcp (no key, or X-API-Key; keyless Codex uses https://api.keenable.ai/mcp-public), or https://api.keenable.ai/mcp-oauth for OAuth sign-in. These docs are an MCP server at https://docs.keenable.ai/mcp and the OpenAPI spec is at https://docs.keenable.ai/api-reference/openapi.json
> Keenable searches and fetches public web pages. If a question needs no web information, skip the call.
> On 402 with an API key (code insufficient_credits), stop and ask a human to add credits; don't retry. On 429, wait the number of seconds in Retry-After, then retry. Before you ship, follow https://docs.keenable.ai/production.md
> Every error, with its cause and fix, is in https://docs.keenable.ai/errors.md and moving from another search API is covered in https://docs.keenable.ai/migrate.md
> Before you compare Keenable with another search API, read https://docs.keenable.ai/guides/evaluate-search-apis.md

# career-ops job search plugin for Keenable

> Find job postings on employers' own ATS pages from career-ops with the Keenable plugin: a search command and a portals.yml provider. No key needed.

*Plugin in career-ops*

The Keenable plugin for [career-ops](https://github.com/career-ops-hq/career-ops), the open-source job search pipeline, finds postings on employers' own applicant tracking pages, such as Greenhouse, Lever and Ashby. You run it as a command or as a provider in `portals.yml`. It works without an API key, and Keenable maintains it.

→ [career-ops-plugin-keenable on GitHub](https://github.com/keenableai/career-ops-plugin-keenable)

## Install

The plugin is listed in the career-ops plugin registry. From your career-ops folder, add it, then enable it:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
node plugins.mjs add keenable
node plugins.mjs enable keenable            # shows the capability card
node plugins.mjs enable keenable --confirm  # grants it
```

The plugin's registry entry allows one host, `api.keenable.ai`, and needs no environment variables.

## Search for postings

Preview the postings for a query with `--dry-run`:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
node plugins.mjs run keenable search "remote machine learning engineer" --dry-run
```

Without `--dry-run`, the command appends the new postings to `data/pipeline.md`. A query keeps its operators as written, so a `search_queries` line from `portals.yml` works too:

```bash theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
node plugins.mjs run keenable search 'site:jobs.ashbyhq.com OR site:jobs.lever.co "Product Designer" remote'
```

## Scan with portals.yml

Set `provider: keenable` and a `scan_query` on an entry in `portals.yml`. `node scan.mjs` then runs that query with the plugin, without spending model tokens:

```yaml theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
job_boards:
  - name: Remote ML roles (Keenable)
    provider: keenable
    scan_query: '"machine learning engineer" remote'
    max_results: 30          # optional, 1-50

tracked_companies:
  - name: Reddit
    provider: keenable
    scan_query: 'site:job-boards.greenhouse.io/reddit "machine learning"'
```

career-ops applies `data/blacklist.md`, `title_filter` and `location_filter` to the results and records what it adds in `data/scan-history.tsv`.

## Settings

Optional settings go in `config/plugins.yml`:

```yaml theme={"theme":{"light":"github-light-high-contrast","dark":"dark-plus"}}
plugins:
  keenable:
    enabled: true
    max_results: 20        # results per query, 1-50
    days_back: 30          # only pages published in the last N days
    sites:                 # replaces the default ATS hosts
      - job-boards.greenhouse.io
      - jobs.ashbyhq.com
```

| Setting | Where | What it does |
| - | - | - |
| `max_results` | `config/plugins.yml` or a `portals.yml` entry | Results per query, 1 to 50. |
| `days_back` | `config/plugins.yml` | Keeps only pages published in the last N days. |
| `sites` | `config/plugins.yml` | Replaces the default hosts: `job-boards.greenhouse.io`, `boards.greenhouse.io`, `jobs.lever.co`, `jobs.ashbyhq.com`, `apply.workable.com`, `jobs.smartrecruiters.com`, `myworkdayjobs.com`. |
| `KEENABLE_API_KEY` | `.env` | Optional. Sends searches with your key instead of the keyless endpoint. |

The plugin keeps single postings only. A board's index page, a hit on another site or a duplicate is dropped, and every result links to the employer's own posting. Each request carries the query text, the result count, an `X-Keenable-Title: career-ops` header and your key if you set one. Nothing from your CV, tracker or pipeline is sent.

> [!NOTE]
>
> Without a key, searches run on the shared public tier at [lower rate limits](https://docs.keenable.ai/rate-limits.md). If the hourly limit is reached, the run stops with a message that says so. Add `KEENABLE_API_KEY` to `.env` to use your organization's limits. See [API keys](https://docs.keenable.ai/api-keys.md).

## Related pages

> [card] [Obscura](https://docs.keenable.ai/integrations/obscura.md)
>
> Add a web\_search tool to Obscura's MCP server with OBSCURA\_WEB\_SEARCH=keenable, so the agent finds pages before it browses them. No key needed.

> [card] [ZeroClaw](https://docs.keenable.ai/integrations/zeroclaw.md)
>
> Select Keenable as the web search provider in ZeroClaw, the Rust agent runtime. It works without an API key.

> [card] [hyperresearch](https://docs.keenable.ai/integrations/hyperresearch.md)
>
> Use Keenable as the web provider in hyperresearch, the deep-research pipeline, for search and page fetch. No key or extra install, 0.13.1 and later.

> [card] [Search quickstart](https://docs.keenable.ai/products/search.md)
>
> Give your agent ranked web pages with excerpts ready to cite. Try it with no API key. Code, cost per mode, filters by site, date and domain, and gotchas.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.