# Run JavaScript against live websites, hosted (/use-cases/hosted-javascript)

You send a short async script, Bowmark runs it against live websites, and you get back whatever it returned. Nothing to install or deploy. It works from Claude, ChatGPT, Cursor, a cron job or your own code.

## What you can call

| Call                        | What it does                                                    |
| --------------------------- | --------------------------------------------------------------- |
| `GET /v1/library?query=...` | Lists the functions for a site or task. Free.                   |
| `POST /v1/run`              | Runs a script and returns `result`, `logs`, `ms` and a `runId`. |
| `POST /v1/scripts`          | Saves a script so you can run it later by name.                 |
| `bowmark.read.page(url)`    | Reads any page into text inside a script.                       |

Over MCP the same thing is two tools: `get_library` and `run`.

## Try it

```sh
curl -sS -X POST https://api.bowmark.ai/v1/run \
  -H "Authorization: Bearer $BOWMARK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"script":"const { offers } = await bowmark.pcparts.search(\"RTX 5080\"); return offers.slice(0,3);"}'
```

Add the MCP server to Claude Code with this command. Other clients are on [Installation](/docs/installation).

```sh
claude mcp add bowmark --transport http https://api.bowmark.ai/mcp --header "Authorization: Bearer $BOWMARK_API_KEY"
```

## FAQ

### Do I write selectors or scraping code?

No. Scripts call typed functions like `bowmark.pcparts.search()` that return fields such as `price` and `url`.

### Can I run a script on a schedule?

Yes. Save it with `POST /v1/scripts`, then call it from cron, n8n or Zapier. See [Schedules](/docs/schedules) and [HTTP API](/docs/http-api#saved-scripts).

### What if a site has no function?

Use `bowmark.read.page(url)`. See [Scripting](/docs/scripting).

### Can a script use a signed-in account?

Yes, on sites with signed-in functions. See [Signed-in sites](/docs/signed-in-sites).

### What does it cost?

Your first $10 is free, then you pay per run. See [Pricing](/docs/pricing).

## Next

Follow the [Quickstart](/docs/quickstart), or read [Scripting](/docs/scripting).
