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
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Tabstack connection
In AgentKit > Connections, create a Tabstack connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'tabstack'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'tabstack_extract_markdown',toolInput: { url: 'https://example.com/pricing' },})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "tabstack"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Tabstack:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={"url":"https://example.com/pricing"},tool_name="tabstack_extract_markdown",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_tooltabstack_extract_jsonFetch a web page and extract the data on it into JSON that matches a schema you give.Read-onlyExtract 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-onlyExtract 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-onlyGenerate 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-onlyResearch 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.
No tools match.