Add a connector

If the source your app needs is not available, add a connector in vana-com/data-connectors.

Fork or branch data-connectors

Scaffold a connector

node skills/vana-connect/scripts/scaffold.cjs <platform> [company]

Implement the connector

Implement the connector script and metadata under connectors/<company>/.

Add JSON schemas

Add JSON schemas under connectors/<company>/schemas/.

Validate the connector

node scripts/validate-connector.cjs connectors/<company>/<name>-playwright.js

Run the connector locally

node run-connector.cjs connectors/<company>/<name>-playwright.js --pretty

Validate the result

node scripts/validate-connector.cjs \
  connectors/<company>/<name>-playwright.js \
  --check-result ~/.dataconnect/last-result.json

node skills/vana-connect/scripts/register.cjs \
  connectors/<company>/<name>-playwright.js

Open a pull request

Open a pull request against vana-com/data-connectors.

After the connector is accepted, use the source ID and scope IDs from the connector in your app.

References