wire_build
Create and publish new scraper actions for sites missing from the catalog. Provide URL and goal; optionally add actions, country, or login credentials. The scraper is auto-tested before release.
Instructions
Request brand-new Wire actions for a website that isn't in the catalog yet — a full catalog build. Describe the site (website_url) and what to build (goal); optionally list the discrete capabilities as actions (each becomes its own action), pin the proxy exit country, and attach a login credential to build actions behind a sign-in. Wire generates and auto-tests the scrapers, then publishes them. Asynchronous — the response's build_request carries an id and status "pending"; when it completes, its skipped list names anything the build could not deliver. Charges credits (login builds cost significantly more than public builds), refunded automatically if the build fails. Track progress with wire_build_status. Only use this after wire_discover / wire_catalog confirm no existing action covers the site.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | Natural-language description of what the action should do or extract. Be specific — the builder synthesizes the scraper from this. | |
| force | No | Build even if similar actions already exist for the domain (otherwise the request is rejected with ACTION_EXISTS). | |
| actions | No | Optional list of discrete capabilities to build, each as its own action (e.g. ["search products", "get product details"]). Omit to let the builder infer them from `goal`. | |
| country | No | Optional 2-letter country code (e.g. "US") — the scraper is built and tested through an exit IP in that country. Use when the site geo-gates its content. | |
| catalog_id | No | Optional — attach to an existing catalog instead of creating one. | |
| credential | No | Optional login credential, for building actions behind a sign-in (a login build — costs significantly more credits than a public build). Plain shape: { type: "plain", username, password }. Vault shape (an entry in a connected 1Password/Azure identity source): { type: "vault", source_id, source_ref }. Either shape may add `login_url` when the login form lives somewhere other than website_url. The password is used once by the builder to sign in and is never stored. | |
| visibility | No | Action visibility. Defaults to private. | private |
| website_url | Yes | The site to build an action for. The domain is extracted automatically. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | "ok" on acceptance. | |
| build_request | No | The created build request — its `id` and `status` ("pending") track the asynchronous build; once finished, `skipped` names anything the build could not deliver. |