Skip to main content

A simple Python package for SEO position tracking from Google and other search engines.

Project description

SEO Position Tracker 📡

A simple Python tool for SEO position tracking from Google and other search engines.

Downloads licence

🔎 Current search engines support

⚙️Installation

$ pip install seo-position-tracker
$ git clone https://github.com/dimitryzub/seo-position-tracking.git

🤹‍♂️Usage

Available CLI arugments:

$ python seo_position_tracker.py -h 
SerpApi SEO position tracker.

optional arguments:
  -h, --help         show this help message and exit
  --api-key API_KEY  your SerpApi API key. For more: https://serpapi.com/manage-api-key
  -se SE             search engine. Currently only one can be passed. Default: Google
  -po                returns website position only.
  -q Q               search query. Default: "Coffee"
  -tk TK             target keyword to track. Default: "coffee". Currently only one can be passed.
  -tw TW             target website to track. Default: "starbucks.com". Currently only one can be passed.
  -l L               language of the search. Default: "en" - English. For more: https://serpapi.com/google-languages
  -c C               country of the search. Default: "us" - United States. For more: https://serpapi.com/google-countries
  -loc LOC           location of the search. Default: "United States". For more: https://serpapi.com/locations-api
  --to-csv           saves results in the current directory to csv.
  --to-json          saves results in the current directory to json.

Example:

$ python seo_position_tracker.py --api-key=<your_serpapi_api_key> \
> -q="minecraft buy" \
> -tk minecraft \
> -tw minecraft.net \
> -l en -c us
[
  {
    "position": 1,
    "country_of_the_search": "us",
    "title": "Get Minecraft: Gaming Platform Features",
    "link": "https://www.minecraft.net/en-us/get-minecraft"
  },
  {
    "position": 5,
    "country_of_the_search": "us",
    "title": "I Want to Buy Minecraft on a Non-Windows Device",
    "link": "https://help.minecraft.net/hc/en-us/articles/6661712171405-I-Want-to-Buy-Minecraft-on-a-Non-Windows-Device"
  }
]

Get position only

$ python seo_position_tracker.py --api-key=<your_serpapi_api_key> \
> -q="minecraft buy" \
> -tk minecraft \
> -tw  minecraft.net \
> -l en -c us \
> -po
[1]
# or 
[1, 5, ...]

💡Issues or suggestions

Visit issues page.

📜 Licence

SEO Position Tracker is released under the BSD-3-Clause Licence.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

seo-position-tracker-1.0.0.tar.gz (4.9 kB view hashes)

Uploaded Source

Built Distribution

seo_position_tracker-1.0.0-py3-none-any.whl (5.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page