## Table of Contents

- [Installation](#installation)
  - [From Node.js](#from-nodejs)
  - [From Edge](#from-edge)
  - [From Browser](#from-browser)

---

[API](https://microlink.io/docs/api/getting-started/overview)

[GUIDES](https://microlink.io/docs/guides) [MQL](https://microlink.io/docs/mql/getting-started/overview) [SDK](https://microlink.io/docs/sdk/getting-started/overview) [CARDS](https://microlink.io/docs/cards/getting-started/overview)

API GUIDES MQL SDK CARDS

Getting Started

[Overview](https://microlink.io/docs/mql/getting-started/overview)

[Installation](https://microlink.io/docs/mql/getting-started/installation)

[Usage](https://microlink.io/docs/mql/getting-started/usage)

[API](https://microlink.io/docs/mql/getting-started/api)

Rules Definition

[Basic rule](https://microlink.io/docs/mql/rules/basic)

[Nested rules](https://microlink.io/docs/mql/rules/nested)

[Rules fallbacks](https://microlink.io/docs/mql/rules/fallbacks)

Data definition

[attr](https://microlink.io/docs/mql/data/attr)

[evaluate](https://microlink.io/docs/mql/data/evaluate)

[selector](https://microlink.io/docs/mql/data/selector)

[selectorAll](https://microlink.io/docs/mql/data/selectorAll)

[type](https://microlink.io/docs/mql/data/type)

API GUIDES MQL SDK CARDS

Getting Started

[Overview](https://microlink.io/docs/mql/getting-started/overview)

[Installation](https://microlink.io/docs/mql/getting-started/installation)

[Usage](https://microlink.io/docs/mql/getting-started/usage)

[API](https://microlink.io/docs/mql/getting-started/api)

Rules Definition

[Basic rule](https://microlink.io/docs/mql/rules/basic)

[Nested rules](https://microlink.io/docs/mql/rules/nested)

[Rules fallbacks](https://microlink.io/docs/mql/rules/fallbacks)

Data definition

[attr](https://microlink.io/docs/mql/data/attr)

[evaluate](https://microlink.io/docs/mql/data/evaluate)

[selector](https://microlink.io/docs/mql/data/selector)

[selectorAll](https://microlink.io/docs/mql/data/selectorAll)

[type](https://microlink.io/docs/mql/data/type)

## Installation

[Copy for LLM](https://microlink.io/docs/mql/getting-started/installation.md "Copy content for LLM")

\|

[View as Markdown](https://microlink.io/docs/mql/getting-started/installation.md "View content as Markdown")

**MQL** is available as

[npm package](https://www.npmjs.com/package/@microlink/react)

:

```bash
npm install @microlink/mql --save
```

The package is fully typed, and it has been designed for being consumed in different environments and ways.

### From Node.js

Any Node.js above v22 is supported. We recommend running it using the active LTS. Check

[Node.js releases](https://nodejs.dev/en/about/releases/)

to know more.

Just require `@microlink/mql` dependency from your code:

```js
const mql = require('@microlink/mql')

const { data } = await mql('https://kikobeats.com', {

  data: {

    avatar: {

      selector: '#avatar',

      type: 'image',

      attr: 'src'

    }

  }

})

console.log(`The avatar URL is '${data.avatar.url}' (${data.avatar.size_pretty})`)
```

The same build is available for CommonJS and ESM.

### From Edge

If you are using

[CloudFlare Workers](https://workers.cloudflare.com/)

, [Vercel Edge Functions](https://vercel.com/features/edge-functions), [Deno](https://deno.com/), or any other provider that supports [WinterCG](https://wintercg.org/), the Node.js ESM build is implemented on top of Web Standard APIs, nothing extra should be done.

Just import `@microlink/mql/lightweight` from your code:

```js
import mql from '@microlink/mql/lightweight'

const { data } = await mql('https://kikobeats.com', {

  data: {

    avatar: {

      selector: '#avatar',

      type: 'image',

      attr: 'src'

    }

  }

})

console.log(`The avatar URL is '${data.avatar.url}' (${data.avatar.size_pretty})`)
```

The same build is available for CommonJS and ESM.

### From Browser

Last but not least, MQL can be loaded from any browser directly from HTML markup:

```html
<script type="module">

  import mql from 'https://esm.sh/@microlink/mql'

  const { data } = await mql('https://kikobeats.com', {

    data: {

      avatar: {

        selector: '#avatar',

        type: 'image',

        attr: 'src',

      }

    }

  })

  console.log(`The avatar URL is '${data.avatar.url}' (${data.avatar.size_pretty})`)

</script>
```

Last updated on April 8, 2026

[Edit on GitHub](https://github.com/microlinkhq/www/blob/master/src/content/docs/mql/getting-started/installation.md)