Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to DaData

Scalekit connector
Open markdown

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

Tools
47
What they doRead · write · destructive
47 · 0 · 047 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 DaData connection

    In AgentKit > Connections, create a DaData 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 = 'dadata'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize DaData:', 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: 'dadata_address_find',
    toolInput: { query: '9120b43f-2fae-4838-a144-85e43c2bfb29' },
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their DaData 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
  • dadata_address_findFind an address by an exact identifier: FIAS or GAR ID, KLADR code, or cadastral number of a building.Read-only

    Find Address by ID

    Find an address by an exact identifier: FIAS or GAR ID, KLADR code, or cadastral number of a building. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to expand a stored ID into a full address. Use dadata_address_suggest for free text.

    Inputs

    querystringrequired
    FIAS/GAR ID, KLADR code or cadastral number of the address. Example: 9120b43f-2fae-4838-a144-85e43c2bfb29.
    countinteger
    Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
    divisionstring
    Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL.one of ADMINISTRATIVEMUNICIPAL
    languagestring
    Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en.one of ruen
  • dadata_address_geolocateReverse-geocode: find the addresses nearest to a latitude and longitude in Russia, nearest first.Read-only

    Find Addresses Near Coordinates

    Reverse-geocode: find the addresses nearest to a latitude and longitude in Russia, nearest first. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to turn coordinates into a street address. Use dadata_address_iplocate to find a city from an IP address.

    Inputs

    latnumberrequired
    Latitude in decimal degrees. Example: 55.878.
    lonnumberrequired
    Longitude in decimal degrees. Example: 37.653.
    countinteger
    Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
    divisionstring
    Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL.one of ADMINISTRATIVEMUNICIPAL
    languagestring
    Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en.one of ruen
    radius_metersinteger
    Search radius in meters. Defaults to 100, maximum 1000. Example: 50.
  • dadata_address_iplocateDetect the Russian city of an IP address.Read-only

    Find City by IP Address

    Detect the Russian city of an IP address. Returns a location object with the city's address data (region, city, KLADR and FIAS IDs, coordinates), or null when the city cannot be determined. Use this to pre-fill a city for a visitor. Accuracy is 60 to 80 percent.

    Inputs

    ipstringrequired
    IPv4 or IPv6 address to locate. Example: 46.226.227.20.
    divisionstring
    Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL.one of ADMINISTRATIVEMUNICIPAL
    languagestring
    Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en.one of ruen
  • dadata_address_suggestSuggest Russian (or, with locations country *, worldwide) postal addresses for free-text input, using the FIAS (GAR) register.Read-only

    Suggest Addresses

    Suggest Russian (or, with locations country *, worldwide) postal addresses for free-text input, using the FIAS (GAR) register. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data includes postal code, region, city, street, house, FIAS and KLADR IDs, coordinates and OKATO/OKTMO codes. Use this to autocomplete or normalize an address typed by a person. Use dadata_address_find for an exact FIAS or KLADR ID.

    Inputs

    querystringrequired
    Address text to complete, up to 300 characters, e.g. a street and city. Example: москва хабар.
    countinteger
    Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
    divisionstring
    Address hierarchy to use: ADMINISTRATIVE (the default) or MUNICIPAL division. Example: MUNICIPAL.one of ADMINISTRATIVEMUNICIPAL
    from_boundobject
    Lowest address level to suggest, as {"value": level}. Levels: country, region, area, city, settlement, street, house, flat. Use with to_bound to suggest e.g. only cities. Example: {"value": "city"}
    languagestring
    Language of the returned addresses: ru (Russian, the default) or en (transliterated). Example: en.one of ruen
    locationsarray
    Limit results to these parent areas, as a list of objects such as {"region": "москва"}, {"kladr_id": "7700000000000"}, {"fias_id": "..."} or {"country": "*"} for all countries. At most 10 objects. Example: [{"region": "москва"}]
    locations_boostarray
    Rank results from these cities first, as a list of objects with a kladr_id, e.g. [{"kladr_id": "77"}]. At most 10 objects. Example: [{"kladr_id": "77"}]
    locations_geoarray
    Limit results to circles around points, as a list of objects with lat, lon and radius_meters, e.g. [{"lat": 59.94, "lon": 30.31, "radius_meters": 1000}]. Example: [{"lat": 59.94, "lon": 30.31, "radius_meters": 1000}]
    to_boundobject
    Highest address level to suggest, as {"value": level}, e.g. {"value": "settlement"}. Example: {"value": "settlement"}
  • dadata_bank_findFind a Russian bank by an exact BIC, SWIFT code, INN, INN/KPP or Bank of Russia registration number.Read-only

    Find Bank by BIC, SWIFT or INN

    Find a Russian bank by an exact BIC, SWIFT code, INN, INN/KPP or Bank of Russia registration number. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to get payment details for a known identifier. Use dadata_bank_suggest for names or partial input.

    Inputs

    querystringrequired
    BIC, SWIFT, INN, INN/KPP or registration number. Example: 044525225.
    countinteger
    Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
  • dadata_bank_suggestSuggest Russian banks and credit organizations for a name, BIC, SWIFT, INN or address.Read-only

    Suggest Banks

    Suggest Russian banks and credit organizations for a name, BIC, SWIFT, INN or address. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Data includes BIC, SWIFT, INN, KPP, correspondent account, registration number, address and status. Use this to autocomplete a bank. Use dadata_bank_find for an exact BIC.

    Inputs

    querystringrequired
    Bank name, BIC, SWIFT, INN or address. Example: сбер.
    countinteger
    Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
    locationsarray
    Limit results to these parent areas, as a list of objects such as {"region": "москва"}, {"kladr_id": "7700000000000"}, {"fias_id": "..."} or {"country": "*"} for all countries. At most 10 objects. Example: [{"region": "москва"}]
    locations_boostarray
    Rank results from these cities first, as a list of objects with a kladr_id, e.g. [{"kladr_id": "77"}]. At most 10 objects. Example: [{"kladr_id": "77"}]
    statusarray
    Limit to these statuses: ACTIVE, LIQUIDATING, LIQUIDATED. Example: ["ACTIVE"]
    typearray
    Limit to these types: BANK, BANK_BRANCH, NKO, NKO_BRANCH, RKC, CBR, TREASURY, OTHER. Example: ["BANK"]
  • dadata_car_brand_findFind one entry of the Car Brands directory by its exact brand ID.Read-only

    Find Car Brands by Code

    Find one entry of the Car Brands directory by its exact brand ID. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this when the code is known. Use dadata_car_brand_suggest for text.

    Inputs

    querystringrequired
    Exact brand ID. Example: FORD.
    countinteger
    Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
  • dadata_car_brand_suggestSuggest car brands by name in Russian or English for partial input.Read-only

    Suggest Car Brands

    Suggest car brands by name in Russian or English for partial input. Returns a suggestions array; each item has value (display text), unrestricted_value and a data object with the record's fields. Use this to autocomplete a value from the directory. Use dadata_car_brand_find for an exact code.

    Inputs

    querystringrequired
    Name or part of the code to search. Example: форд.
    countinteger
    Maximum number of results to return. Defaults to 10, maximum 20. Example: 5.
    filtersarray
    Optional filters that narrow the results, as a list of objects whose keys are fields of the returned data. Objects in the list are combined with OR, keys inside one object with AND. Example: [{"region_code": "77"}].