Skip to content

Create a resource file

A resource file is a CSV file that lists OSINT tools and services. It can be imported when creating an investigation or from the resource library, and exported at any time.

What is it for?

Rather than creating your resources one by one in the interface, you can prepare your own catalog of tools in CSV and import it in a single operation. Handy for sharing a toolset with a team or migrating from another tool.

File format

The file must be comma-delimited (,) and UTF-8 encoded.

Required columns

ColumnRequiredDescription
nameYesResource name
typeYes"website" or "script" (includes software)
descriptionNoShort description
urlNoURL without https:// or http://
queryUrlNoURL with placeholder
genericNo"yes" for all types, "no" for specific types
typesTargetedNoList of targeted entity types

Example file

csv
name,type,description,url,queryUrl,generic,typesTargeted
Google,website,Search engine,google.com,google.com/search?q={{value}},yes,
SocialScan,script,Find accounts by username,,,,clh6rf805twci0bujhft9fc5m
Epieos,website,Email investigation,epieos.com,epieos.com/results?q={{value}},no,clh6r9r6wtvwa0buj4osvepjb
Shodan,website,Search engine for devices,shodan.io,shodan.io/search?query={{value}},no,clh6sgxq9tww10buuhzho55jg

The queryUrl field

The queryUrl lets you automatically open the tool with the selected entity's value. Use the placeholder, which is replaced by the entity's value at click time.

Examples:

  • google.com/search?q= — Google search with the value
  • epieos.com/results?q= — Epieos search with the email
  • shodan.io/search?query= — Shodan search with the IP

Do not include https:// in the URL — the application adds it automatically.

The typesTargeted field

This field determines for which entity types the resource appears in the detail panel.

To get the type IDs:

  1. Open Main menu → Types selector
  2. Select the desired type(s) (Ctrl+Click for several)
  3. Use the Copy text button (or Copy for Excel if you work in a spreadsheet)
  4. Paste the IDs into the typesTargeted column

Import the file

When creating an investigation

In the creation dialog, a button lets you associate a resource set. You can create a new set by importing your CSV.

From the resource library

  1. Go to Resources
  2. Click Import
  3. Select your CSV file

Imported resources are added to your library without overwriting existing resources with a different name.

Export your resources

To export your custom resources to CSV (to back them up or share them):

  1. Go to Resources
  2. Click Export

The generated CSV follows exactly the format expected for a later re-import.

Tips

  • Start by exporting your existing resources to get a concrete example of the expected format
  • Test your queryUrl by manually opening the URL in a browser with a real value in place of
  • For generic resources (usable with all entity types), set generic to "yes" and leave typesTargeted empty

Osintracker user guide