However, you might prefer using your own editor, locally on your machine. We made Phantombuster’s SDK specifically for this.
The SDK will monitor a directory on your disk for changes in your scripts. As soon as a change is detected, the script will be uploaded in your Phantombuster account.
Because we made the SDK as a Node module, you need to have
npm (Node Package Manager) installed on your machine. Then type:
# npm install -g phantombuster-sdk
This will globally install the
All your scripts will go in a project directory. You can arrange the contents of this directory however you like (by creating a sub-directory for each category of scripts for example).
You can choose any name for this directory. For example:
$ mkdir phantom-project
All the SDK’s configuration goes into a single file named
phantombuster.cson at the root of your project directory. It’s written in CoffeeScript Object Notation (
Open/create this file with the editor of your choice:
$ vi phantom-project/phantombuster.cson
Configuration is very simple:
[ name: 'account name' apiKey: 'YOUR_API_KEY_HERE' scripts: 'my-script.js': 'project/test/my-script.js' 'another-script.coffee': 'folder/script.coffee' ]
nameis an arbitrary
Stringof your choice. People generally put in the name of their Phantombuster account.
This name is shown each time a script is successfully saved on Phantombuster’s servers.
apiKeymust contain the API key of your Phantombuster account as a
You can find it in your settings page (click Reveal). It’s important to keep this key secret because it allows anyone in its possession to manipulate your Phantombuster account (
phantombuster.csonis a private file and should not be shared). If you think your API key has been compromised, do not hesitate to generate a new one.
PlainObjectcontaining a list of scripts that you wish to manage with the SDK.
Each line (key/value pair) represents a script. The key (left side) is the script’s name on Phantombuster (therefore it must not contain any special characters or any slashes). The value (right side) is the location of this script’s file on your machine’s disk, in your project directory (in fact, relative to the location of
To start the SDK, simply navigate to your project directory and execute the
$ cd phantom-project $ phantombuster
This will start a monitoring process. If any modification happens to your script’s files, they will automatically be saved in your Phantombuster account.
It means you can now start the editor of your choice and start developping your bots in an environment you like.
phantombuster [-c config.cson] [script1.coffee [script2.coffee...]]
You can specify another configuration file with the
You can also provide one or more paths to scripts to upload them to your Phantombuster account (without starting the monitoring process).