Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sethblack/python-seo-analyzer
An SEO tool that analyzes the structure of a site, crawls the site, count words in the body of the site and warns of any technical SEO issues.
https://github.com/sethblack/python-seo-analyzer
analyzer python python-3 python-seo-analyzer python3 search-engine seo seo-monitor seo-optimization technical-seo
Last synced: 1 day ago
JSON representation
An SEO tool that analyzes the structure of a site, crawls the site, count words in the body of the site and warns of any technical SEO issues.
- Host: GitHub
- URL: https://github.com/sethblack/python-seo-analyzer
- Owner: sethblack
- License: other
- Created: 2012-12-28T21:52:13.000Z (about 12 years ago)
- Default Branch: main
- Last Pushed: 2024-12-16T21:26:55.000Z (about 1 month ago)
- Last Synced: 2025-01-15T20:15:40.972Z (6 days ago)
- Topics: analyzer, python, python-3, python-seo-analyzer, python3, search-engine, seo, seo-monitor, seo-optimization, technical-seo
- Language: Python
- Homepage:
- Size: 160 KB
- Stars: 1,211
- Watchers: 61
- Forks: 312
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
Python SEO and GEO Analyzer
===================
A modern SEO and GEO analysis tool that combines technical optimization and authentic human value. Beyond traditional site crawling and structure analysis, it uses AI to evaluate content's expertise signals, conversational engagement, and cross-platform presence. It helps you maintain strong technical foundations while ensuring your site demonstrates genuine authority and value to real users.
The AI features were heavily influenced by the clickbait-titled SEL article [A 13-point roadmap for thriving in the age of AI search](https://searchengineland.com/seo-roadmap-ai-search-449199).
Installation
------------
### PIP
```
pip install pyseoanalyzer
```
### Docker
The docker image is available on [Docker Hub](https://hub.docker.com/r/sethblack/python-seo-analyzer) and can be run with the same command-line arguments as the script.
```
docker run sethblack/python-seo-analyzer [ARGS ...]
```
Command-line Usage
------------------
If you run without a sitemap it will start crawling at the homepage.
```sh
seoanalyze http://www.domain.com/
```
Or you can specify the path to a sitmap to seed the urls to scan list.
```sh
seoanalyze http://www.domain.com/ --sitemap path/to/sitemap.xml
```
HTML output can be generated from the analysis instead of json.
```sh
seoanalyze http://www.domain.com/ --output-format html
```
API
---
The `analyze` function returns a dictionary with the results of the crawl.
```python
from pyseoanalyzer import analyze
output = analyze(site, sitemap)
print(output)
```
In order to analyze heading tags (h1-h6) and other extra additional tags as well, the following options can be passed to the `analyze` function
```python
from pyseoanalyzer import analyze
output = analyze(site, sitemap, analyze_headings=True, analyze_extra_tags=True)
print(output)
```
By default, the `analyze` function analyzes all the existing inner links as well, which might be time consuming.
This default behaviour can be changed to analyze only the provided URL by passing the following option to the `analyze` function
```python
from pyseoanalyzer import analyze
output = analyze(site, sitemap, follow_links=False)
print(output)
```
Alternatively, you can run the analysis as a script from the seoanalyzer folder.
```sh
python -m seoanalyzer https://www.sethserver.com/ -f html > results.html
```
AI Optimization
---------------
The first pass of AI optimization features use Anthropic's `claude-3-sonnet-20240229` model to evaluate the content of the site. You will need to have an API key from [Anthropic](https://www.anthropic.com/) to use this feature. The API key needs to be set as the environment variable `ANTHROPIC_API_KEY`. I recommend using a `.env` file to set this variable. Once the API key is set, the AI optimization features can be enabled with the `--run-llm-analysis` flag.
Notes
-----
If you get `requests.exceptions.SSLError` at either the command-line or via the python-API, try using:
- http://www.foo.bar
**instead** of..
- https://www.foo.bar