Let your AI run the browser.

You sayWhat macros do I have in SmartMacros?

All macros saved in SmartMacros with id, name, start URL, step count, data rows and last run status.

No arguments.

{}

[
  {
    "id": "m_k2f9",
    "name": "Add lead to CRM",
    "startUrl": "https://crm.northwind.io/leads/new",
    "steps": 7,
    "rows": 6,
    "lastRun": {"status": "fix"}
  }
]

You sayShow me the steps of the Add lead to CRM macro.

Full JSON of one macro: steps with their locators, data source, variables, triggers.

{"id": "m_k2f9"}

{
  "id": "m_k2f9",
  "name": "Add lead to CRM",
  "steps": [
    {"type": "navigate", "value": "https://crm.northwind.io/leads/new"},
    {
      "type": "type",
      "label": "Enter '{{email}}' in Email",
      "target": {
        "locators": [{"kind": "id", "value": "#email"}]
      }
    }
  ]
}

You sayMake a macro that adds a lead to crm.northwind.io from a name and an email.

Saves a new macro. Read smartmacros://guide first. Steps need only type, target (locators), value and options; ids, labels and defaults are filled in by SmartMacros.

{
  "name": "Add lead to CRM",
  "startUrl": "https://crm.northwind.io/leads/new",
  "steps": [
    {"type": "navigate", "value": "https://crm.northwind.io/leads/new"},
    {
      "type": "type",
      "target": {
        "locators": [{"kind": "label", "value": "Email"}]
      },
      "value": "{{email}}"
    },
    {
      "type": "click",
      "target": {
        "locators": [
          {"kind": "text", "value": "Save lead", "tag": "button"}
        ]
      }
    }
  ],
  "dataSource": {
    "columns": ["email"],
    "rows": [["jane@brightsupply.co"]]
  }
}

{
  "saved": {"id": "m_k2f9", "name": "Add lead to CRM", "steps": 3, "rows": 1},
  "steps": [
    "1. Open crm.northwind.io/leads/new",
    "2. Enter '{{email}}' in Email",
    "3. Click on 'Save lead' button"
  ]
}

You sayAdd a step to that macro that ticks the consent box before saving.

Replaces the given fields of an existing macro. Pass steps to replace the whole step list; pass dataSource to replace the data rows.

{"id": "m_k2f9", "name": "Add lead to CRM (EU)"}

{
  "saved": {"id": "m_k2f9", "name": "Add lead to CRM (EU)", "steps": 3}
}

You sayDelete the macro called Old price check.

Deletes a macro permanently.

{"id": "m_k2f9"}

{"deleted": "m_k2f9"}

You sayRun Add lead to CRM for these five people.

Runs a saved macro in Chrome. mode 'once' runs it one time, 'rows' once per data row. With wait=true (default) the call returns when the run finishes or needs the user, with per-row results, variables and repairs.

{"id": "m_k2f9", "mode": "rows"}

{
  "status": "finished",
  "rows": 6,
  "rowStatus": ["done", "done", "healed", "done", "done", "done"],
  "repairs": 1,
  "results": [
    {
      "row": 1,
      "status": "done",
      "values": {"ticket": "T-1042"}
    }
  ],
  "log": ["ok: Run finished, 1 repair"]
}

You sayHow is the run going?

State of the current or last run: status, row, step, repairs, variables, whether it waits for the user, last log lines.

No arguments.

{}

{
  "status": "running",
  "macroName": "Add lead to CRM",
  "row": 3,
  "rows": 6,
  "stepIndex": 4,
  "stepCount": 7,
  "repairs": 1,
  "needsUser": null
}

You saySkip that row and keep going.

When run_status shows status waiting_user: retry the step, skip it, skip the row, continue after a pause, or stop. Picking an element on the page needs the user.

{"choice": "skipRow"}

{"status": "running", "row": 4, "rows": 6}

You sayStop the run.

Stops the current run. Rows already finished stay finished.

No arguments.

{}

{"status": "finished", "aborted": true}

You sayOpen the supplier portal.

Opens a URL in a new tab and makes it active. Returns the tab id for page_snapshot and find_elements.

{"url": "https://portal.brightsupply.co/catalog"}

{
  "tabId": 412,
  "title": "Catalog",
  "url": "https://portal.brightsupply.co/catalog"
}

You sayLook at the page I have open. What can you fill in?

Title, URL, visible text and the interactive elements of the active tab (or tabId), each with a ready-to-use locator. Use it before writing steps for a page.

{"maxElements": 40}

{
  "title": "New lead",
  "url": "https://crm.northwind.io/leads/new",
  "text": "New lead Full name Email ...",
  "elements": [
    {
      "tag": "input",
      "type": "email",
      "label": "Email",
      "locators": [
        {"kind": "id", "value": "#email"},
        {"kind": "label", "value": "Email"}
      ]
    }
  ]
}

You sayFind the Export button on this page.

Finds elements on the active tab (or tabId) that match a description such as 'email field' or 'Save button', scored, each with locators to put into a step target.

{"description": "Save button"}

[
  {
    "score": 1,
    "kind": "button",
    "text": "Save lead",
    "locators": [
      {"kind": "id", "value": "#save-lead"},
      {"kind": "text", "value": "Save lead", "tag": "button"}
    ]
  }
]

You sayFill this form with my details and press Save. Do not save a macro.

Runs a list of steps in the active tab (or at url) without saving a macro. Use it to control the browser directly: open a page, fill a form, read values. Same executor and repairs as saved macros.

{
  "url": "https://example.com/search",
  "steps": [
    {
      "type": "type",
      "target": {
        "locators": [{"kind": "css", "value": "input[type=search]"}]
      },
      "value": "smartmacros",
      "options": {"pressEnter": true}
    },
    {
      "type": "extractList",
      "target": {
        "locators": [{"kind": "css", "value": ".results h3"}]
      },
      "value": "titles"
    }
  ]
}

{
  "status": "finished",
  "repairs": 0,
  "vars": {"titles": ["First result", "Second result"]}
}

You sayWhat ran today, and did anything fail?

Recent runs with macro name, rows done, repairs and results.

{"limit": 2}

[
  {
    "macroName": "Add lead to CRM",
    "rows": 6,
    "done": 6,
    "failed": 0,
    "repairs": 1,
    "aborted": false
  }
]

You sayWhich steps did SmartMacros repair this week?

Steps SmartMacros repaired: macro, step, old and new locator, who solved it, confidence.

{"limit": 1}

[
  {
    "macroName": "Add lead to CRM",
    "step": 3,
    "stepLabel": "Enter '{{email}}' in Email",
    "by": "heuristic",
    "from": "#email",
    "to": "#fld-7f3a",
    "confidence": 0.79,
    "status": "saved"
  }
]

You sayAre you connected to SmartMacros?

Whether the SmartMacros extension is connected to this bridge, and its build.

No arguments.

{}

{"connected": true, "extensionBuild": "0.4.0", "port": 37421}