@axiom_ai/api 1.0.1 → 1.0.2

package/AGENTS.md

@@ -0,0 +1,3 @@
+# AGENTS.md
+
+This package documents its agent conventions, public API surface, common patterns, and error semantics in [`CLAUDE.md`](./CLAUDE.md) — read that file first, regardless of which agent you're running. Runnable examples live in [`examples/`](./examples/).

package/CLAUDE.md

@@ -0,0 +1,154 @@
+# CLAUDE.md — `@axiom_ai/api` agent instructions
+
+Reference doc Claude (and other agents following the AGENTS.md convention) read when working with this package — both inside this repo and after `npm install @axiom_ai/api` puts a copy at `node_modules/@axiom_ai/api/CLAUDE.md` in a consumer project. Keep this terse and code-truth-aligned; the actual source-of-truth is [`src/axiom-api.js`](./src/axiom-api.js).
+
+## What this package is
+
+A small Node library that drives Axiom.ai's cloud browser pool over a REST API (`/api/v5/*`). It is **not** a Puppeteer/Playwright wrapper and **does not** speak CDP — it calls named step functions on a Laravel backend (`https://lar.axiom.ai`) that run inside the cloud browser. If you want raw CDP, that's the separate Chrome API surface — see [the website's API overview](https://axiom.ai/docs/developer-hub/api).
+
+Bundled in the npm tarball alongside source-built `dist/`:
+- This file (`CLAUDE.md`) — surface + patterns.
+- `AGENTS.md` — redirect to here for non-Claude agents.
+- `examples/` — three runnable Node scripts: `simple-scrape.js`, `login-then-extract.js`, `parallel-sessions.js`.
+
+## Public method surface
+
+Every method below is on the `AxiomApi` class. Construct with `new AxiomApi(apiKey)`; the key comes from the user's account (see "Auth + signup" below).
+
+### Lifecycle (always pair these)
+
+| Method | Notes |
+|---|---|
+| `browserOpen()` | Opens a cloud browser session. Returns the CDP endpoint and caches it on the instance as `axiom.cdpLink`. |
+| `browserClose(cdpLink?)` | Closes the session. Pass `cdpLink` only if closing a session from a different instance (rare). |
+
+**Wrap every script in `try { … } finally { await axiom.browserClose() }`** so a thrown step doesn't leak a cloud session.
+
+### Navigation
+
+| Method | Notes |
+|---|---|
+| `goto(url, doNotShareLocalstorage?, openInNewTab?)` | Navigate the current tab (or a new one if third arg is `true`). |
+| `switchBrowserTab(selectTab)` | Switch focus to a tab by name/URL substring. |
+
+### Interaction
+
+| Method | Notes |
+|---|---|
+| `click(select, leftClickRightClick?, optionalClick?)` | Single click. `optionalClick: true` no-ops when the selector doesn't match. |
+| `clickMultiple(select, leftClickRightClick?, maxClicks?)` | Click every match up to `maxClicks`. |
+| `clickEngagementButton(select, setValueToCheck)` | Idempotent like/follow/subscribe toggle. |
+| `hover(select)` | Mouse-over an element. |
+| `clickAndDrag(startCoordinates, endCoordinates)` | Mouse-down at one point, release at another. Coordinates are `{scrollX, scrollY, clientX, clientY}` objects. |
+| `enterText(selectTextField, text, delay?, appendExisting?, customLineBreak?, optionalText?)` | Type into an input field. |
+| `pressKeys(key, delimiter?, delay?)` | Fire keyboard events (Enter, Tab, arrow keys, modifier combos). |
+| `selectList(select, text)` | Pick an option from a `<select>` by visible text. |
+| `datePicker(selectMonth, selectMonthChangeButton, changeMonthTo, changeDayOfMonthTo)` | Step through a calendar widget. |
+
+### Data
+
+| Method | Notes |
+|---|---|
+| `scrape(url, selector, pager, max_results, settings)` | Smart-scrape rows. Pass `null` for `url` to scrape the current page. Returns an array of objects. |
+| `scrapeMetadata(metadata)` | Extract structured page-level fields (title, OG tags, schema.org blocks). |
+| `getClipboardContents()` | Read the cloud browser's clipboard (after a copy step). |
+
+### AI and utility
+
+| Method | Notes |
+|---|---|
+| `integrateAI(aiOptions)` | Inline LLM call (extract or generate). `aiOptions: {aiFunction, key?, model?, prompt?, extractData?, promptExtract?}`. |
+| `solveCaptcha(apiKey?)` | Hand the current page's captcha to a third-party solver. Omit `apiKey` to use the one stored on the account. |
+| `wait(time)` | Pause **on the cloud pod** (keeps the session alive) for `time` ms. Use this rather than client-side `setTimeout`. |
+| `restartBrowser()` | Restart Chrome within the same session — useful between unrelated flows. |
+
+## Methods NOT to call
+
+These exist on the class but are not part of the public surface — don't emit them in generated code:
+
+- `step(mode, method, params, cdpLink)` — the internal dispatcher every public method routes through. If you ever feel like calling `step()` directly, that means a named wrapper is missing; file an issue, don't paper over it.
+- `_sleep(ms)` — client-side sleep helper. Internal; use `wait(time)` (cloud-side) for browser pacing.
+- `_pollStepResult(...)` / `_shouldFallBackToPolling(...)` — error-recovery internals.
+
+## Common patterns
+
+### Simplest scrape — open, navigate, scrape, close
+
+```javascript
+import { AxiomApi } from '@axiom_ai/api'
+
+const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+await axiom.browserOpen()
+try {
+    await axiom.goto('https://example.com/products')
+    const rows = await axiom.scrape(null, '.product-card', null, 50, {})
+    console.log(`Found ${rows.length} products`)
+} finally {
+    await axiom.browserClose()
+}
+```
+
+### Login then extract
+
+```javascript
+await axiom.goto('https://example.com/login')
+await axiom.enterText('input[name=email]', process.env.LOGIN_EMAIL)
+await axiom.enterText('input[name=password]', process.env.LOGIN_PASSWORD)
+await axiom.click('button[type=submit]')
+await axiom.wait(2000)                              // settle on the dashboard
+const rows = await axiom.scrape(null, '.row', null, 100, {})
+```
+
+### Parallel sessions
+
+Create independent `AxiomApi` instances — each calls `browserOpen()` and `browserClose()` independently. Don't share `cdpLink` between them.
+
+```javascript
+const a = new AxiomApi(KEY); const b = new AxiomApi(KEY)
+await Promise.all([a.browserOpen(), b.browserOpen()])
+try {
+    const [rowsA, rowsB] = await Promise.all([
+        a.goto('https://a.test').then(() => a.scrape(null, '.row', null, 50, {})),
+        b.goto('https://b.test').then(() => b.scrape(null, '.row', null, 50, {})),
+    ])
+} finally {
+    await Promise.all([a.browserClose(), b.browserClose()])
+}
+```
+
+See [`examples/`](./examples/) for runnable versions of these.
+
+## Error semantics
+
+The library throws `AxiomHttpError` on non-2xx responses. Common shapes:
+
+| Status | Meaning | What to do |
+|---|---|---|
+| 401 | API key invalid / expired | Re-mint the key — don't retry. |
+| 403 | Account-level block (quota, abuse, plan) | Don't retry; surface to the user. |
+| 409 | A step is already in flight on this `cdpLink` | Library auto-polls `/api/v5/step/result` and returns the result transparently. You shouldn't normally see 409 propagate. |
+| 502 / 503 / 504 | Pod transient | Library auto-falls-back to polling. If still failing after polling, retry the whole `browserOpen → … → browserClose` flow. |
+| Other 4xx | Bad params (wrong selector type, missing required arg) | Inspect the error body and fix the call. |
+
+## Auth + signup
+
+The `AXIOM_API_KEY` env var holds the long-lived key. Two ways to get one:
+
+1. **Interactive** — sign up at [axiom.ai](https://axiom.ai), open the dashboard, copy the key.
+2. **Programmatic** — three-call flow documented at [`/docs/developer-hub/api/programmatic-signup`](https://axiom.ai/docs/developer-hub/api/programmatic-signup): `POST /api/user/create` → `POST /api/user/login` → `GET /api/user/key/create`. Suitable for headless onboarding.
+
+## Relationship to `@axiom_ai/claude-skill`
+
+If the user is asking Claude to **build an axiom from a prompt** (e.g. "scrape this site daily and email me", "build me a bot that…"), the explicit marketplace plugin [`@axiom_ai/claude-skill`](https://github.com/axiom-browser-automation/claude-skill) gives Claude a richer guided experience — it covers both the *coded* path (this package) and the *no-code* path (saving to the user's dashboard). Use it when the user wants Claude to *invent* an axiom; this CLAUDE.md is enough when the user is *writing their own code* and asking Claude for help with the API surface.
+
+## Build + test (for maintainers working in this repo)
+
+```bash
+npm ci          # install deps
+npm test        # jest, 26 tests, runs against nock mocks (no live calls)
+npm run build   # vite produces dist/{es,cjs}/index.js; tsc emits .d.ts only
+```
+
+**Watch-out from v1.0.1**: `tsconfig.json` is set to `emitDeclarationOnly: true`. If you change that, `tsc` will start emitting multi-file `.js` into `dist/es/` and clobber vite's single-bundle build — the result imports fine under CJS but fails under modern Node ESM with `ERR_MODULE_NOT_FOUND` on extensionless internal imports. Leave the flag alone unless you also wire up vite/tsc differently.
+
+Publishing is via the Jenkins job `Publishing/axiom-api-publish` on the team's Jenkins; manual trigger only.

package/README.md

@@ -30,4 +30,14 @@ async function run() {
 }
 
 run();
-```
+```
+
+## Working with Claude Code (or other agents)
+
+This package bundles agent-targeted documentation alongside the runtime:
+
+- [`CLAUDE.md`](./CLAUDE.md) — full method surface, error semantics, common patterns, auth + signup, and the methods *not* to call. Read by Claude automatically when this package is installed in a project.
+- [`AGENTS.md`](./AGENTS.md) — same content, surfaced for non-Claude agents that follow the `AGENTS.md` convention.
+- [`examples/`](./examples/) — three runnable scripts (`simple-scrape.js`, `login-then-extract.js`, `parallel-sessions.js`).
+
+If you want Claude to *invent* an axiom from a prompt rather than help you write API calls yourself, also see [`@axiom_ai/claude-skill`](https://github.com/axiom-browser-automation/claude-skill) — the marketplace plugin covers both this library and the no-code dashboard path.

package/dist/cjs/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k="https://lar.axiom.ai";class c extends Error{constructor(t,e,n){super(t),this.name="AxiomHttpError",this.status=e,this.body=n}}class m{async post(t,e,n,i={}){const s=new AbortController;let o=null;i.timeoutMs&&i.timeoutMs>0&&(o=setTimeout(()=>s.abort(),i.timeoutMs));let r;try{r=await fetch(k+t,{method:"POST",headers:{Accept:"application/json","Content-Type":"application/json","X-API-KEY":e},body:JSON.stringify(n),signal:s.signal})}finally{o&&clearTimeout(o)}if(!r.ok){const h=await r.text();let a=null;try{a=JSON.parse(h)}catch{}if(r.status===401)throw new c("Failed to authenticate - please check your token.",401,a);const w=a&&a.message?a.message:`HTTP ${r.status} error: ${h}`;throw new c(w,r.status,a)}return r.json()}}const y=12e4,u=36e5,f=3e3,l=3e4,d=1.5;class g{constructor(t){this.cdpLink="",this.token=t,this.http=new m}async browserOpen(){const t=await this.http.post("/api/v5/browser/open",this.token);return this.cdpLink=t.endpoint,t.endpoint}async browserClose(t=""){t||(t=this.cdpLink);const e=await this.http.post("/api/v5/browser/close",this.token,{cdpLink:t});return this.cdpLink="",e.message}async step(t,e,n,i=""){try{const s=await this.http.post("/api/v5/step",this.token,{mode:t,method:e,params:n,cdpLink:i},{timeoutMs:y});return s&&s.message!==void 0?s.message:s}catch(s){if(!i||!this._shouldFallBackToPolling(s))throw s;return this._pollStepResult(i,s)}}_shouldFallBackToPolling(t){return!!(t&&t.name==="AbortError"||t&&t.name==="TypeError"||t instanceof c&&(t.status===502||t.status===503||t.status===504||t.status===409&&typeof t.message=="string"&&t.message.indexOf("Step already in progress")!==-1))}async _pollStepResult(t,e){const n=Date.now()+u;let i=f;for(;Date.now()<n;){await this._sleep(i);try{const s=await this.http.post("/api/v5/step/result",this.token,{cdpLink:t});if(s&&s.status==="complete")return s.result;if(s&&s.status==="running"){i=Math.min(i*d,l);continue}throw s&&s.status==="none"?new Error("Step did not start on the pod. Original error: "+(e&&e.message?e.message:"unknown")):new Error("Unexpected /step/result response: "+JSON.stringify(s))}catch(s){if(s instanceof c&&s.status===409)throw new Error("Step failed on the pod — check the task report. "+(s.message||""));if(s instanceof c&&s.status>=400&&s.status<500&&s.status!==502&&s.status!==503&&s.status!==504)throw s;i=Math.min(i*d,l)}}throw new Error("Step polling exceeded "+u/1e3+"s. Original error: "+(e&&e.message?e.message:"unknown"))}async scrape(t,e,n,i,s){return this.step("browser","AxiomApiSmartScrapeV440",[t,e,n,i,s],this.cdpLink)}async integrateAI(t){return this.step("browser","AxiomApiAiGeneric",[t],this.cdpLink)}async datePicker(t,e,n,i){return this.step("driver","datePicker",[t,e,n,i],this.cdpLink)}async click(t,e,n){return this.step("driver","clickV3130",[t,e,n],this.cdpLink)}async clickEngagementButton(t,e){return this.step("driver","clickEngagementButton",[t,e],this.cdpLink)}async clickMultiple(t,e,n){return this.step("driver","multiClickV3170",[t,e,n],this.cdpLink)}async getClipboardContents(){return this.step("driver","readClipboardContents",[],this.cdpLink)}async enterText(t,e,n=0,i=!1,s=null,o=!1){return this.step("driver","enterTextV4500",[t,e,n,i,s,o],this.cdpLink)}async goto(t,e=!1,n=!1){return this.step("driver","gotoV4070",[t,null,e,n],this.cdpLink)}async pressKeys(t,e,n){return this.step("driver","keydownV3120",[t,null,e,n],this.cdpLink)}async clickAndDrag(t,e){return this.step("driver","mouseClickDragV0300",[t,e],this.cdpLink)}async scrapeMetadata(t){return this.step("driver","scrapeMetadata",[t],this.cdpLink)}async selectList(t,e){return this.step("driver","selectList",[t,e],this.cdpLink)}async solveCaptcha(t){return this.step("driver","solveCaptchaV450",[null,null,t],this.cdpLink)}async switchBrowserTab(t){return this.step("driver","switchBrowserTab",[t],this.cdpLink)}async wait(t){return this.cdpLink?this.step("driver","wait",[t],this.cdpLink):this._sleep(t)}_sleep(t){return new Promise(e=>setTimeout(e,t))}async hover(t){return this.step("driver","hover",[t],this.cdpLink)}async restartBrowser(){return this.step("browser","AxiomApiRestartBrowser",[],this.cdpLink)}}exports.AxiomApi=g;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k="https://lar.axiom.ai";class c extends Error{constructor(t,e,n){super(t),this.name="AxiomHttpError",this.status=e,this.body=n}}class m{async post(t,e,n,i={}){const s=new AbortController;let o=null;i.timeoutMs&&i.timeoutMs>0&&(o=setTimeout(()=>s.abort(),i.timeoutMs));let r;try{r=await fetch(k+t,{method:"POST",headers:{Accept:"application/json","Content-Type":"application/json","X-API-KEY":e},body:JSON.stringify(n),signal:s.signal})}finally{o&&clearTimeout(o)}if(!r.ok){const h=await r.text();let a=null;try{a=JSON.parse(h)}catch{}if(r.status===401)throw new c("Failed to authenticate - please check your token.",401,a);const w=a&&a.message?a.message:`HTTP ${r.status} error: ${h}`;throw new c(w,r.status,a)}return r.json()}}const y=12e4,u=36e5,f=3e3,l=3e4,d=1.5;class g{constructor(t){this.cdpLink="",this.token=t,this.http=new m}async browserOpen(){const t=await this.http.post("/api/v5/browser/open",this.token);return this.cdpLink=t.endpoint,t.endpoint}async browserClose(t=""){t||(t=this.cdpLink);const e=await this.http.post("/api/v5/browser/close",this.token,{cdpLink:t});return this.cdpLink="",e.message}async step(t,e,n,i=""){try{const s=await this.http.post("/api/v5/step",this.token,{mode:t,method:e,params:n,cdpLink:i},{timeoutMs:y});return s&&s.message!==void 0?s.message:s}catch(s){if(!i||!this._shouldFallBackToPolling(s))throw s;return this._pollStepResult(i,s)}}_shouldFallBackToPolling(t){return!!(t&&t.name==="AbortError"||t&&t.name==="TypeError"||t instanceof c&&(t.status===502||t.status===503||t.status===504||t.status===409&&typeof t.message=="string"&&t.message.indexOf("Step already in progress")!==-1))}async _pollStepResult(t,e){const n=Date.now()+u;let i=f;for(;Date.now()<n;){await this._sleep(i);try{const s=await this.http.post("/api/v5/step/result",this.token,{cdpLink:t});if(s&&s.status==="complete")return s.result;if(s&&s.status==="running"){i=Math.min(i*d,l);continue}throw s&&s.status==="none"?new Error("Step did not start on the pod. Original error: "+(e&&e.message?e.message:"unknown")):new Error("Unexpected /step/result response: "+JSON.stringify(s))}catch(s){if(s instanceof c&&s.status===409)throw new Error("Step failed on the pod — check the task report. "+(s.message||""));if(s instanceof c&&s.status>=400&&s.status<500&&s.status!==502&&s.status!==503&&s.status!==504)throw s;i=Math.min(i*d,l)}}throw new Error("Step polling exceeded "+u/1e3+"s. Original error: "+(e&&e.message?e.message:"unknown"))}async scrape(t,e,n,i,s){return this.step("browser","AxiomApiSmartScrapeV4400",[t,e,n,i,s],this.cdpLink)}async integrateAI(t){return this.step("browser","AxiomApiAiGeneric",[t],this.cdpLink)}async datePicker(t,e,n,i){return this.step("driver","datePicker",[t,e,n,i],this.cdpLink)}async click(t,e,n){return this.step("driver","clickV3130",[t,e,n],this.cdpLink)}async clickEngagementButton(t,e){return this.step("driver","clickEngagementButton",[t,e],this.cdpLink)}async clickMultiple(t,e,n){return this.step("driver","multiClickV3170",[t,e,n],this.cdpLink)}async getClipboardContents(){return this.step("driver","readClipboardContents",[],this.cdpLink)}async enterText(t,e,n=0,i=!1,s=null,o=!1){return this.step("driver","enterTextV4500",[t,e,n,i,s,o],this.cdpLink)}async goto(t,e=!1,n=!1){return this.step("driver","gotoV4070",[t,null,e,n],this.cdpLink)}async pressKeys(t,e,n){return this.step("driver","keydownV3120",[t,null,e,n],this.cdpLink)}async clickAndDrag(t,e){return this.step("driver","mouseClickDragV0300",[t,e],this.cdpLink)}async scrapeMetadata(t){return this.step("driver","scrapeMetadata",[t],this.cdpLink)}async selectList(t,e){return this.step("driver","selectList",[t,e],this.cdpLink)}async solveCaptcha(t){return this.step("driver","solveCaptchaV450",[null,null,t],this.cdpLink)}async switchBrowserTab(t){return this.step("driver","switchBrowserTab",[t],this.cdpLink)}async wait(t){return this.cdpLink?this.step("driver","wait",[t],this.cdpLink):this._sleep(t)}_sleep(t){return new Promise(e=>setTimeout(e,t))}async hover(t){return this.step("driver","hover",[t],this.cdpLink)}async restartBrowser(){return this.step("browser","AxiomApiRestartBrowser",[],this.cdpLink)}}exports.AxiomApi=g;

package/dist/es/index.js

@@ -100,7 +100,7 @@ class _ {
   async scrape(t, e, n, i, s) {
     return this.step(
       "browser",
-      "AxiomApiSmartScrapeV440",
+      "AxiomApiSmartScrapeV4400",
       [t, e, n, i, s],
       this.cdpLink
     );

package/examples/README.md

@@ -0,0 +1,17 @@
+# Examples
+
+Runnable Node scripts demonstrating common `@axiom_ai/api` patterns. Each is small (20-30 lines), ES-module syntax, and reads its API key from `AXIOM_API_KEY` in the environment.
+
+| File | Demonstrates |
+|---|---|
+| [`simple-scrape.js`](./simple-scrape.js) | Smallest valid axiom — `browserOpen → goto → scrape → browserClose` with `try/finally`. |
+| [`login-then-extract.js`](./login-then-extract.js) | `enterText` + `click` + `wait` for an auth flow, then scrape behind the login. |
+| [`parallel-sessions.js`](./parallel-sessions.js) | Two `AxiomApi` instances side by side — each has its own lifecycle. |
+
+Run any of them with:
+
+```bash
+AXIOM_API_KEY=your-key node simple-scrape.js
+```
+
+The full method surface, error semantics, and patterns reference is in [`../CLAUDE.md`](../CLAUDE.md).

package/examples/login-then-extract.js

@@ -0,0 +1,25 @@
+// Log into a site, then scrape behind auth. Demonstrates: enterText, click, wait.
+
+import { AxiomApi } from '@axiom_ai/api'
+
+async function main() {
+  const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+
+  await axiom.browserOpen()
+  try {
+    await axiom.goto('https://example.com/login')
+    await axiom.enterText('#email', process.env.SITE_EMAIL)
+    await axiom.enterText('#password', process.env.SITE_PASSWORD)
+    await axiom.click('button[type=submit]')
+    // Wait on the pod (keeps the session alive) rather than a local setTimeout.
+    await axiom.wait(2000)
+
+    await axiom.goto('https://example.com/dashboard')
+    const rows = await axiom.scrape(null, '.report-row', null, 100, {})
+    return rows
+  } finally {
+    await axiom.browserClose()
+  }
+}
+
+await main()

package/examples/parallel-sessions.js

@@ -0,0 +1,26 @@
+// Drive two sessions in parallel. Each gets its own AxiomApi instance + lifecycle.
+// Demonstrates that browserClose() is per-instance, not global.
+
+import { AxiomApi } from '@axiom_ai/api'
+
+async function scrapeOne(url) {
+  const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+  await axiom.browserOpen()
+  try {
+    await axiom.goto(url)
+    return await axiom.scrape(null, '.item', null, 20, {})
+  } finally {
+    await axiom.browserClose()
+  }
+}
+
+async function main() {
+  const urls = [
+    'https://example.com/category/a',
+    'https://example.com/category/b'
+  ]
+  const results = await Promise.all(urls.map(scrapeOne))
+  console.log('Total rows:', results.flat().length)
+}
+
+await main()

package/examples/simple-scrape.js

@@ -0,0 +1,20 @@
+// Smallest valid axiom: open browser, navigate, scrape, close.
+// Validator checks: methods on allowlist, try/finally lifecycle, no hardcoded token.
+
+import { AxiomApi } from '@axiom_ai/api'
+
+async function main() {
+  const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+
+  await axiom.browserOpen()
+  try {
+    await axiom.goto('https://example.com/products')
+    const rows = await axiom.scrape(null, '.product-card', null, 50, {})
+    console.log(`Found ${rows.length} products`)
+    return rows
+  } finally {
+    await axiom.browserClose()
+  }
+}
+
+await main()

package/package.json

@@ -2,13 +2,16 @@
   "name": "@axiom_ai/api",
   "author": "Axiom.ai",
   "type": "module",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Library for interacting with Axiom.ai browser infrastructure",
   "main": "dist/cjs/index.js",
   "module": "dist/es/index.js",
   "types": "dist/es/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "examples"
   ],
   "scripts": {
     "build:js": "vite build --mode production",
@@ -56,7 +59,11 @@
     "axiom.ai",
     "sdk",
     "browser",
-    "automation"
+    "automation",
+    "claude",
+    "claude-code",
+    "agents-md",
+    "llm-friendly"
   ],
   "license": "ISC",
   "bugs": {