The keyword generator provide multiple commands in order to generate and manage a set of keyphrases for SEO monitoring tools such as AWRCloud, the tool currently used at Liip for internal SEO. It takes an unusual yet powerful generative approach: given a list of patterns composed by keyword_placeholders, and given a list of keywords for each keyword_placeholder, the tool generates all keyphrases (= keyword combinations) corresponding to the patterns based on the keywords listed for each keyword_placeholder, accordingly to the languages associated with each keyword.

For a more basic keyword composition tool, see MergeWords.

Commands:

To get general help on the keyword generator:

kwgen

To know options for each commands:

kwgen [COMMAND] --help

Download or clone the repository from github.

Then:

sudo python setup.py install

A short example.

Given ...

A project directory with the following structure:

ROOT_DIR
|
+-- patterns.csv
+-- keyword_placeholders
    +-- [placeholder_1].csv
    +-- ...

patterns.csv file which lists keyphrases patterns, which are composed by keyword_placeholders separated by spaces. Note how patterns are attributed to one or many language (the same will go for placeholder files):

pattern,languages,tag,example keyphrase
theme,fr|en|de,priority-1|words-1,'e-commerce'
theme organisation,en|de,priority-2|words-2,'e-commerce agency'
organisation theme,fr,priority-2|words-2,'agence e-commerce'
theme service,en|de, priority-3|words-2,'e-commerce development'
service theme,fr,priority-3|words-2,'développement e-commerce'

A /keyword_placeholders/ folder of [PLACEHOLDER].csv files detailing the real keywords behind each placeholder (in the above defined patterns, there are three placeholders: theme, organisation, and service):

/keyword_placeholders/theme.csv:

keyword,languages
web,fr|en
internet,fr|en

/keyword_placeholders/organisation.csv:

keyword,languages
agentur,de
agency,en
agence,fr

/keyword_placeholders/service.csv:

keyword,languages
design,en|fr|de
développement,fr
development,en
entwicklung,de

... the script will output all possible keyword combinations in the following keywords.csv file:

keyphrase,lang,topics,tags
agence internet,fr,organisation|theme,priority-2|words-2
agence web,fr,organisation|theme,priority-2|words-2
design internet,fr,service|theme,priority-3|words-2
design web,fr,service|theme,priority-3|words-2
développement internet,fr,service|theme,priority-3|words-2
développement web,fr,service|theme,priority-3|words-2
internet,de|en|fr,theme,priority-1|words-1
internet agency,en,organisation|theme,priority-2|words-2
internet agentur,de,organisation|theme,priority-2|words-2
internet design,de|en,service|theme,priority-3|words-2
internet development,en,service|theme,priority-3|words-2
internet entwicklung,de,service|theme,priority-3|words-2
web,de|en|fr,theme,priority-1|words-1
web agency,en,organisation|theme,priority-2|words-2
web agentur,de,organisation|theme,priority-2|words-2
web design,de|en,service|theme,priority-3|words-2
web development,en,service|theme,priority-3|words-2
web entwicklung,de,service|theme,priority-3|words-2

It is possible to attribute groups to patterns – in our above example, we assign the 'prio-1' and 'prio-2' groups to the patterns. Multiple groups can be associated to a pattern by separating them with "|".

When uploading keyphrases to AWRCloud, keyword groups will automatically be associated to uploaded keywords.

The using the command

kwgen upload-awr

The following groups will be created in AWRCloud:

• for each pattern underlying a keyphrase, a group 'pattern_[PATTERN-NAME]' will be assigned
• for each language associated with the keyphrase, a group 'lang_[LANGUAGE]' will be assigned
• a group corresponding to each placeholder associated with the pattern will be assigned. For example, if the pattern is "service location", the associated group will be : "pattern_service-location".

Store your username and password in the file [HOME_DIRECTORY]/.kwgen/config.ini using the following structure:

[authentication]
username = xxx
password = yyy