N’importe quel site. Derrière n’importe quel login. Appelable.

Un seul appel transforme un site en API. Writ vérifie d’abord vos propres workflows et les offres prêtes à l’emploi — les deux gratuits — puis son agent pilote un vrai navigateur et enregistre le workflow. Interrogez l’id de build ; le résultat a son propre endpoint.

# One call. Writ's agent drives the browser and saves the workflow.
curl -X POST https://api.usewrit.app/api/v1/website-to-api \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://acme.example",
       "goal": "return a SKU'"'"'s price and stock"}'

{ "build_id": 2291,
  "status": "queued",
  "goal": "return a SKU's price and stock" }

⚠Le slug existe parce que vous avez publié ce workflow, et la clé est une clé consommateur créée avec lui — pas la clé de votre compte.

Une ligne, et le site devient une API : dites ce qu’elle doit renvoyer et Writ ouvre un vrai navigateur, retrouve les appels derrière la page et enregistre le résultat comme workflow.

claude mcp add writ-cloud \
  -e WRIT_API_KEY=wt_your_api_key \
  -- npx -y writ-mcp

# then, one line in the session:
writ_website_to_api({
  url:  "https://acme.example",
  goal: "return a SKU's price and stock",
})

Clients à fichier de config — Claude Desktop · Cursor · Windsurf

Le workflow sauvegardé devient son propre outil run_<name>, se rejoue sans coût d’IA et peut être planifié. Vous préférez REST ? L’onglet cURL montre le même démarrage : POST /api/v1/website-to-api.

npm install github:usewrit/writ-sdks --workspace typescript

import { WritAgent, runRowId } from "@usewrit/agent-sdk";

const client = new WritAgent();              // discovers the running agent + token
const { data: workflows } = await client.workflows.list();
const run = await client.workflows.runAndWait(workflows[0].id, {
  inputs: { city: "Paris" },
});
const { data: rows } = await client.runs.data(runRowId(run));
console.log(run.status, rows);

Ceux-ci pilotent le démon LOCAL sur votre machine, où les exécutions sont gratuites et non comptées. L’onglet cURL ci-dessus est l’endpoint cloud publié.

pip install "git+https://github.com/usewrit/writ-sdks#subdirectory=python"

from writ_agent import WritAgent, run_row_id

with WritAgent() as client:                  # discovers the local daemon
    run = client.workflows.run_and_wait(3, inputs={"city": "Paris"})
    print(run["status"], run["rows_extracted"])
    print(client.runs.data(run_row_id(run))["data"])   # extracted rows

Ceux-ci pilotent le démon LOCAL sur votre machine, où les exécutions sont gratuites et non comptées. L’onglet cURL ci-dessus est l’endpoint cloud publié.

go get github.com/usewrit/writ-sdks/go

client, err := writ.Discover(ctx)                        // find the running agent
page, _ := client.Workflows.List(ctx, nil)
item, _ := client.Workflows.RunAndWait(ctx, page.Data[0].ID, nil)
rowID, _ := item.RowID()
csv, _ := client.Runs.DataCSV(ctx, rowID)                // extracted rows as CSV
fmt.Println(item.Status, "
", csv)

Ceux-ci pilotent le démon LOCAL sur votre machine, où les exécutions sont gratuites et non comptées. L’onglet cURL ci-dessus est l’endpoint cloud publié.

cargo add writ-client --git https://github.com/usewrit/writ-sdks

use writ_client::{RunOptions, WritAgent};

let agent = WritAgent::discover().await?;                // find the running daemon
let workflows = agent.workflows().list().await?;
let wf = &workflows.data[0];
let outcome = agent.workflows().run_and_wait(wf.id, &RunOptions::default()).await?;
let rows = agent.runs().data(outcome.run.row_id().unwrap()).await?;
println!("{} → {}: {}", wf.name, outcome.run.status, rows.data);

Ceux-ci pilotent le démon LOCAL sur votre machine, où les exécutions sont gratuites et non comptées. L’onglet cURL ci-dessus est l’endpoint cloud publié.

Un moniteur, c’est un seul POST avec une clé. Aucune installation, aucun agent à lancer — Writ vérifie la page à votre cadence et enregistre chaque changement.

# Watch a page on Writ Cloud — no install, just the key.
curl -X POST https://api.usewrit.app/api/targets \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com",
       "check_type": "content",
       "selector": "h1",
       "check_period_ms": 300000}'

⚠Un intervalle inférieur au minimum de votre plan est refusé net, en nommant le plancher — il n’est jamais ralenti en silence.

Pointez votre assistant vers Writ et il peut créer et câbler les moniteurs lui-même — surveiller une page, puis déclencher une action quand elle bouge.

claude mcp add writ-cloud \
  -e WRIT_API_KEY=wt_your_api_key \
  -- npx -y writ-mcp

# then, one line in the session:
writ_create_monitor({ url: "https://example.com",
                      selector: "h1", interval_minutes: 5 })

writ_wire_monitor({ monitor_id: 47, action: "notify",
                    channels: ["email"] })

Clients à fichier de config — Claude Desktop · Cursor · Windsurf

Les mêmes moniteurs apparaissent dans l’app, l’API et les SDK ; le lieu d’exécution change, le moniteur non.

npm install github:usewrit/writ-sdks --workspace typescript

import { CloudApi } from "@usewrit/agent-sdk";

const cloud = new CloudApi({ apiKey: process.env.WRIT_API_KEY });  // wt_…
const mon = await cloud.monitors.create({
  url: "https://example.com",
  selector: "h1",
  check_period_ms: 300_000,
});
const changes = await cloud.monitors.changes(mon.id, { limit: 50 });

pip install "git+https://github.com/usewrit/writ-sdks#subdirectory=python"

from writ_agent import Cloud

cloud = Cloud(api_key=os.environ["WRIT_API_KEY"])   # wt_… — no daemon needed
mon = cloud.monitors.create({
    "url": "https://example.com",
    "selector": "h1",
    "check_period_ms": 300_000,
})
changes = cloud.monitors.changes(mon["id"], limit=50)

go get github.com/usewrit/writ-sdks/go

client := writ.New(writ.WithAPIKey(os.Getenv("WRIT_API_KEY")))
mon, err := client.Cloud.Monitors.Create(ctx, writ.CloudMonitorParams{
    URL:           "https://example.com",
    Selector:      writ.Ptr("h1"),
    CheckPeriodMs: writ.Ptr(int64(300_000)),
})
changes, _ := client.Cloud.Monitors.Changes(ctx, mon.ID, writ.Ptr(50))

cargo add writ-client --git https://github.com/usewrit/writ-sdks

use serde_json::json;
use writ_client::CloudClient;

let cloud = CloudClient::from_env()?;                // reads WRIT_API_KEY
let mon = cloud.monitors().create(json!({
    "url": "https://example.com",
    "selector": "h1",
    "check_period_ms": 300_000
})).await?;
let changes = cloud.monitors().changes(mon.id, Some(50)).await?;

Un crawl de site complet, c’est un seul POST avec une clé. Writ répartit la graine sur la flotte et livre le résultat comme un jeu de données appelable.

# No account, no key — a few same-domain pages, one level deep.
curl -X POST https://api.usewrit.app/v1/keyless/crawl \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "limit": 3}'

# With a key: the whole site, as a job you poll.
curl -X POST https://api.usewrit.app/api/crawl \
  -H "Authorization: Bearer $WRIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "max_depth": 3, "page_budget": 500}'

curl https://api.usewrit.app/api/crawl/8125 -H "Authorization: Bearer $WRIT_API_KEY"

⚠Aucun compte pour essayer : le palier sans clé crawle quelques pages du même domaine, sur un niveau, dans la limite d’une allocation quotidienne. La portée complète, les logins et un jeu de données appelable demandent une clé.

Pointez votre assistant vers Writ et il peut crawler un site directement, puis relire les lignes sans que vous écriviez un parseur.

claude mcp add writ-cloud \
  -e WRIT_API_KEY=wt_your_api_key \
  -- npx -y writ-mcp

# then, one line in the session:
writ_crawl_site({ url: "https://example.com",
                 intent: "product pages with specs",
                 page_budget: 500, save_as: "example-catalog" })

writ_crawl_status({ crawl_id: 8125 })

Clients à fichier de config — Claude Desktop · Cursor · Windsurf

Avec save_as, le crawl devient réexécutable et appelable : les exécutions suivantes réutilisent les données récentes au lieu de recrawler.

npm install github:usewrit/writ-sdks --workspace typescript

import { CloudApi } from "@usewrit/agent-sdk";

const cloud = new CloudApi({ apiKey: process.env.WRIT_API_KEY });
const job = await cloud.crawl({ url: "https://example.com", max_depth: 3, page_budget: 500 });
const status = await cloud.crawlStatus(job.id);
console.log(status.pages_done, "/", status.pages_discovered);

pip install "git+https://github.com/usewrit/writ-sdks#subdirectory=python"

from writ_agent import Cloud

cloud = Cloud(api_key=os.environ["WRIT_API_KEY"])
job = cloud.crawl("https://example.com", max_depth=3, page_budget=500)
status = cloud.crawl_status(job["id"])
print(status["pages_done"], "/", status["pages_discovered"])

go get github.com/usewrit/writ-sdks/go

client := writ.New(writ.WithAPIKey(os.Getenv("WRIT_API_KEY")))
job, err := client.Cloud.Crawl(ctx, writ.CrawlStartParams{
    URL:        "https://example.com",
    MaxDepth:   writ.Ptr(int64(3)),
    PageBudget: writ.Ptr(int64(500)),
})
status, _ := client.Cloud.CrawlStatus(ctx, job.ID)

cargo add writ-client --git https://github.com/usewrit/writ-sdks

use writ_client::{CloudClient, CrawlStartParams};

let cloud = CloudClient::from_env()?;
let job = cloud.crawl(&CrawlStartParams {
    url: "https://example.com".into(),
    max_depth: Some(3),
    page_budget: Some(500),
    ..Default::default()
}).await?;
let status = cloud.crawl_status(job.id).await?;