Metadata-Version: 2.4
Name: turboseo
Version: 0.3.0
Summary: SEO content toolkit that writes human, not AI
Project-URL: Homepage, https://github.com/thijs/turboseo
Project-URL: Documentation, https://github.com/thijs/turboseo#readme
Project-URL: Repository, https://github.com/thijs/turboseo
Project-URL: Issues, https://github.com/thijs/turboseo/issues
Author: Thijs
License-Expression: MIT
License-File: LICENSE
Keywords: ai-detection,claude-code,content,marketing,seo,writing
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
Classifier: Topic :: Text Processing :: Linguistic
Requires-Python: >=3.10
Requires-Dist: click>=8.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: textstat>=0.7.0
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: scikit-learn>=1.0.0; extra == 'dev'
Provides-Extra: ml
Requires-Dist: scikit-learn>=1.0.0; extra == 'ml'
Description-Content-Type: text/markdown

# TurboSEO

An open-source SEO content toolkit that helps you write content that ranks—and sounds human.

## Why TurboSEO?

Most SEO tools help you optimize for search engines. TurboSEO also optimizes for **not sounding like AI wrote it**.

Based on [Wikipedia's "Signs of AI Writing"](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) guidelines, TurboSEO checks your content for:

- AI vocabulary (delve, tapestry, pivotal, etc.)
- Puffery patterns ("plays a vital role", "stands as a testament")
- Superficial analysis (sentences ending with "highlighting...", "emphasizing...")
- Structural clichés ("In conclusion", "Despite challenges...")

## Features

- **Human Writing Score** (0-100) - Detect AI-sounding patterns
- **SEO Analysis** - Keywords, readability, structure
- **CLI Tool** - Quick analysis from terminal
- **Claude Code Integration** - Slash commands and agents

## Installation

```bash
pip install turboseo
```

For development:

```bash
git clone https://github.com/wavyrai/turboseo.git
cd turboseo
pip install -e ".[dev]"
```

## Quick Start

### Check if content sounds human

```bash
turboseo check article.md
```

### Full SEO analysis

```bash
turboseo analyze article.md --keyword "podcast hosting"
```

### Use with Claude Code

```bash
cd your-content-project
# Copy .claude/ directory from turboseo
/write podcast monetization strategies
```

## Commands

| Command | Description |
|---------|-------------|
| `turboseo check <file>` | Check for AI writing patterns |
| `turboseo analyze <file>` | Full SEO analysis |
| `turboseo readability <file>` | Readability analysis |
| `turboseo keywords <file> -k <keyword>` | Keyword analysis |

## Human Writing Score

TurboSEO scores your content from 0-100:

| Score | Grade | Meaning |
|-------|-------|---------|
| 90-100 | A | Sounds human |
| 80-89 | B | Minor AI tells |
| 70-79 | C | Noticeable AI patterns |
| 60-69 | D | Obvious AI writing |
| <60 | F | Clearly AI-generated |

## Documentation

- [Getting Started](docs/getting-started.md)
- [Human Writing Standards](docs/human-writing-standards.md)
- [CLI Reference](docs/cli-reference.md)
- [Claude Code Integration](docs/claude-code-integration.md)
- [Analyzers Reference](docs/analyzers.md)

## Contributing

Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

MIT License - see [LICENSE](LICENSE) for details.
