Agentic Platform
Documentation API reference Tools Skills

Tools

PageWorkers Generic URLs Actions

pageworkers_generic_urls_actions MCP Collaboration

Update metadata or apply custom changes to URLs (PageWorkers).

This agent creates a PageWorkers optimization for a page from your most recent crawl to update its title, description, or H1 tag.

Playground

Your organization, project and token stay in this browser's local storage and are sent straight to the API — this page never sees them.

POST
item
urls required List of URLs and their metadata updates

Billing

Fixed cost per item requested. This tool reads data Botify already holds for your project and calls no outside service, so nothing is added to the per-call price.

These usage SKUs can be charged on a call.

SKU Credits Description
Tool call 1 per request Charged once per successful item.

Schemas

item is what you send, config how the tool behaves, and the response is what you get back.

Item

object
Properties
urls array required

List of URLs and their metadata updates

Items: URLMetadataUpdate

Example
{
  "urls": [
    {
      "url": "string",
      "title": null,
      "description": null,
      "h1": null,
      "custom_changes": []
    }
  ]
}

Type Definitions

2 types

These are the available sub-object types that can be used in the properties above.

CustomChange object
#

A custom change to apply to the page.

selector string required

CSS selector of the element to update (ex: "h1", ".article-count", etc).

strategy string required

Update strategy to use

Values: prepend append insertAfter insertBefore replace replaceElement

value string required

Value to update

max_date string | null

Maximum date to apply the update (YYYY-MM-DD format)

Default: null

URLMetadataUpdate object
#

Metadata updates to apply to a specific URL.

url string required

Specific URL to update (wildcards like '*' are not allowed)

title string | null

New title to set for the page

Default: null

description string | null

New description to set for the page

Default: null

h1 string | null

New H1 to set for the page

Default: null

custom_changes array

List of custom changes to apply to specific elements on the page

Items: CustomChange

Default: []

max items 10

Response

object
Properties
websiteId string required

The website ID

moduleId string required

The PageWorkers module ID

urls array required

List of URLs and their metadata updates

Items: URLMetadataUpdate

message string required

Message about the operation

organization string required

The organization slug

project string required

The project slug

demo boolean required

Whether the operation was run in demo mode

Example
{
  "websiteId": "string",
  "moduleId": "string",
  "urls": [
    {
      "url": "string",
      "title": null,
      "description": null,
      "h1": null,
      "custom_changes": []
    }
  ],
  "message": "string",
  "organization": "string",
  "project": "string",
  "demo": true
}

Type Definitions

2 types

These are the available sub-object types that can be used in the properties above.

CustomChange object
#

A custom change to apply to the page.

selector string required

CSS selector of the element to update (ex: "h1", ".article-count", etc).

strategy string required

Update strategy to use

Values: prepend append insertAfter insertBefore replace replaceElement

value string required

Value to update

max_date string | null

Maximum date to apply the update (YYYY-MM-DD format)

Default: null

URLMetadataUpdate object
#

Metadata updates to apply to a specific URL.

url string required

Specific URL to update (wildcards like '*' are not allowed)

title string | null

New title to set for the page

Default: null

description string | null

New description to set for the page

Default: null

h1 string | null

New H1 to set for the page

Default: null

custom_changes array

List of custom changes to apply to specific elements on the page

Items: CustomChange

Default: []

max items 10

Endpoints

POST http://agents.botify.com/{organization}/{project}/pageworkers_generic_urls_actions/process
POST http://agents.botify.com/{organization}/{project}/pageworkers_generic_urls_actions/batch_process
POST http://agents.botify.com/{organization}/{project}/pageworkers_generic_urls_actions/async_process
POST http://agents.botify.com/{organization}/{project}/pageworkers_generic_urls_actions/async_batch_process

See running a long job in the background for the polling flow.

cURL

curl -X POST "http://agents.botify.com/{organization}/{project}/pageworkers_generic_urls_actions/process" \
  -H "Authorization: Bearer $BOTIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item": {
    "urls": []
  }
}'

Over MCP

This tool is exposed as the MCP tool pageworkers_generic_urls_actions. An MCP client passes organization, project and item as tool arguments. Set up MCP →

Raw metadata