Skip to main content

User Scripts

Secutils.dev lets you save reusable JavaScript snippets as user scripts and import them directly into responder scripts, API tracker extractor/configurator scripts, and page tracker extractor scripts. Instead of duplicating the same logic in every responder or tracker, you write it once in Settings → Scripts and import it wherever you need it.

Script types

Each script has a type that determines which contexts it can be imported in:

TypeLabelCan be imported in
responderResponderResponder scripts
api_extractorAPI ExtractorAPI tracker data extractor scripts
api_configuratorAPI ConfiguratorAPI tracker request configurator scripts
page_extractorPage ExtractorPage tracker content extractor scripts
universalUniversalAny context

When you open the import modal in an editor, only scripts compatible with that context are shown.

Managing scripts

Navigate to Settings → Scripts to create and manage your scripts.

1
[object Object]

Open the account menu, click Settings, then select the Scripts tab. Click Add script to create your first script.

2
[object Object]

Enter a Name, choose a Type, and write or paste the script content. Click Create when ready.

3
The script appears in the table with its type badge and last-updated timestamp.

The script appears in the table with its type badge and last-updated timestamp.

4
[object Object]

You can add more scripts as needed. Use the Edit action to update a script's content, Duplicate to create a copy, or Delete to remove it.

Naming rules

  • Must start with a letter (a–z, A–Z)
  • Can contain letters, digits, underscores (_), and hyphens (-)
  • Maximum 128 characters

Limits

  • Up to 100 scripts per user (configurable per subscription tier)
  • Maximum script content size: 50 KB

Importing a script into a responder

When you create or edit a responder with Advanced mode enabled, the Script editor exposes an Import action in its toolbar. Clicking it opens a modal listing all scripts whose type is responder or universal.

1
[object Object]

In the responder form, enable Advanced mode. The Script editor appears. Click the Import action (the download icon in the editor toolbar) to open the script picker.

2
[object Object]

Select the script you want to import and click Import. Only scripts compatible with the responder context are listed.

3
The selected script content is inserted into the editor, replacing any existing content.

The selected script content is inserted into the editor, replacing any existing content.

tip

Importing a script copies its content into the editor at the time of import. Subsequent edits to the original script in Settings → Scripts do not automatically update responders or trackers that have already imported it.

Importing a script into an API tracker

API tracker extractor and configurator editors each expose the same Import action. The modal shows only api_extractor, api_configurator, or universal scripts, depending on which editor triggered the import.

1
[object Object]

In the API tracker form, enable Advanced mode. The Data extractor and Request configurator editors appear. Click the Import action in the desired editor to open the script picker.

2
[object Object]

Select the compatible script and click Import. Only scripts of the matching type (api_extractor, api_configurator, or universal) are listed.

3
The script content is inserted into the editor.

The script content is inserted into the editor.

Importing a script into a page tracker

The page tracker Content extractor editor works the same way. The import modal shows only page_extractor or universal scripts.

1
[object Object]

In the page tracker form, the Content extractor editor is always visible. Click the Import action to open the script picker.

2
[object Object]

Select the compatible script and click Import. Only page_extractor and universal scripts are listed.

3
The script content is inserted into the Content extractor editor.

The script content is inserted into the Content extractor editor.