Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Tabstack

Scalekit connector
Open markdown

The Tabstack connector lets your AI agent act in each user's Tabstack account. Each user connects their own Tabstack access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 4 tools.

Tools
4
What they doRead · write · destructive
4 · 0 · 04 read0 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Tabstack connection

    In AgentKit > Connections, create a Tabstack connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'tabstack'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Tabstack:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'tabstack_extract_markdown',
    toolInput: { url: 'https://example.com/pricing' },
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Tabstack credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • tabstack_extract_jsonFetch a web page and extract the data on it into JSON that matches a schema you give.Read-only

    Extract Page Data as JSON

    Fetch a web page and extract the data on it into JSON that matches a schema you give. Returns a JSON object shaped by the schema. Use tabstack_extract_json for data already on the page. Use tabstack_generate_json to summarise or derive data that is not on the page.

    Inputs

    json_schemaobjectrequired
    JSON Schema of the data to extract. Give each property a description; properties named page_title or favicon are filled from page metadata when the page has no value. Example: {"type": "object", "properties": {"plans": {"type": "array", "items": {"type": "object", "properties": {"name": {"type": "string"}, "price": {"type": "number"}}}}}}.
    urlstringrequired
    URL of the page to extract from. Example: https://example.com/pricing.
    effortstring
    Fetch effort: min is fastest with no fallback (1-5 s), standard is balanced (default, 3-15 s), max renders the page in a full browser for JavaScript-heavy sites (15-60 s). Example: standard.one of minstandardmax
    geo_countrystring
    Fetch the page from this country, as an ISO 3166-1 alpha-2 code. Example: US.
    nocacheboolean
    true to bypass Tabstack's cache and fetch fresh content. Example: false.
  • tabstack_extract_markdownFetch a web page and convert it to clean Markdown.Read-only

    Extract Page as Markdown

    Fetch a web page and convert it to clean Markdown. Returns the page content as Markdown, plus Open Graph and HTML metadata when requested. Use tabstack_extract_markdown to read a page. Use tabstack_extract_json to pull specific fields into a schema.

    Inputs

    urlstringrequired
    URL of the page to convert. Example: https://example.com/pricing.
    contentstring
    main returns the main article content (default); full returns the whole page, including navigation, footer and links. Example: main.one of mainfull
    effortstring
    Fetch effort: min is fastest with no fallback (1-5 s), standard is balanced (default, 3-15 s), max renders the page in a full browser for JavaScript-heavy sites (15-60 s). Example: standard.one of minstandardmax
    geo_countrystring
    Fetch the page from this country, as an ISO 3166-1 alpha-2 code. Example: US.
    metadataboolean
    true to also return the page's Open Graph and HTML metadata. Example: false.
    nocacheboolean
    true to bypass Tabstack's cache and fetch fresh content. Example: false.
  • tabstack_generate_jsonFetch a web page and have a model transform its content into JSON that matches a schema, following your instructions.Read-only

    Generate JSON from a Page

    Fetch a web page and have a model transform its content into JSON that matches a schema, following your instructions. Returns a JSON object shaped by the schema. Use tabstack_generate_json to summarise, classify or restructure a page. Use tabstack_extract_json to copy data that is already on the page.

    Inputs

    instructionsstringrequired
    How to transform the page content, up to 20,000 characters. Example: Summarise each plan and who it suits.
    json_schemaobjectrequired
    JSON Schema of the output to produce. Example: {"type": "object", "properties": {"plans": {"type": "array", "items": {"type": "object", "properties": {"name": {"type": "string"}, "price": {"type": "number"}}}}}}.
    urlstringrequired
    URL of the page to read. Example: https://example.com/pricing.
    effortstring
    Fetch effort: min is fastest with no fallback (1-5 s), standard is balanced (default, 3-15 s), max renders the page in a full browser for JavaScript-heavy sites (15-60 s). Example: standard.one of minstandardmax
    geo_countrystring
    Fetch the page from this country, as an ISO 3166-1 alpha-2 code. Example: US.
    nocacheboolean
    true to bypass Tabstack's cache and fetch fresh content. Example: false.
  • tabstack_researchAnswer a question with a cited synthesis of several live web sources.Read-only

    Research the Web

    Answer a question with a cited synthesis of several live web sources. Returns Tabstack's server-sent event stream as text; the final complete event carries the report and its sources. Use tabstack_research for an open question. Use tabstack_extract_markdown or tabstack_extract_json when you already know the URL.

    Inputs

    querystringrequired
    The question to research, up to 10,000 characters. Example: Compare pricing and free tiers of the top 3 product analytics tools.
    fetch_timeoutinteger
    Seconds to wait for each source page. Example: 10.
    modestring
    fast for a quick answer (default) or balanced for standard, deeper research. Example: fast.one of fastbalanced
    nocacheboolean
    true to bypass Tabstack's cache and fetch fresh content. Example: false.