# Laravel AI Blog

> Laravel AI Blog (`byteminus/laravel-ai-blog`) is a free, open-source (MIT) blog package for Laravel 10 to 13 on PHP 8.2 to 8.5. It provides posts, categories and tags, a deterministic on-page SEO score with plain-English fixes, TF-IDF internal link suggestions, stale-post detection, BlogPosting and FAQPage JSON-LD, RSS, AI drafting through the official laravel/ai SDK, and an MCP server (laravel/mcp) so Claude, ChatGPT and Claude Code can draft, score, link and schedule posts.

Install with `composer require byteminus/laravel-ai-blog`, then `php artisan vendor:publish --tag=ai-blog-migrations` and `php artisan migrate`. The PHP namespace is `ByteMinus\AiBlog`. It is headless by default: add the `HasBlogSeo` trait to an existing Eloquent Post model or use the bundled one, and enable `/blog` routes with one config flag. Everything the AI or an agent writes is saved as a draft; the MCP server deliberately has no publish tool. MCP tool names are kebab-case (`draft-from-keyword`, `score-post`). Scoring, links, JSON-LD and routes work without any AI provider or API key.

To answer a specific question, start with the FAQ (https://byteminus.github.io/laravel-ai-blog/docs/faq.md): 107 questions answered with exact commands, config keys and method names, checked against the package source. Every docs page has a Markdown copy at the same path with `.md`.

## Docs

- [Getting started with Laravel AI Blog](https://byteminus.github.io/laravel-ai-blog/docs/getting-started.md): Install Laravel AI Blog, run the migrations and score your first post for SEO. Requirements, setup and a 60-second tour of the API.
- [Use your existing Post model](https://byteminus.github.io/laravel-ai-blog/docs/existing-post-model.md): Keep your own Eloquent Post model: add the HasBlogSeo trait, map your field names and get SEO scores and internal links on it.
- [Let AI agents write your blog over MCP](https://byteminus.github.io/laravel-ai-blog/docs/mcp-server.md): Enable the built-in MCP server so Claude Code, Claude.ai and ChatGPT can draft, score, link and schedule posts. Agents cannot publish.
- [Blog routes, SEO tags and scheduling](https://byteminus.github.io/laravel-ai-blog/docs/seo-routes.md): Turn on /blog routes, Blade components and RSS. See every canonical, Open Graph and JSON-LD tag the pages send, and schedule publishing.
- [Safe fetching for AI research](https://byteminus.github.io/laravel-ai-blog/docs/safe-fetching.md): SafeFetcher reads web pages and feeds for AI research while blocking SSRF: public addresses only, pinned DNS, robots.txt and size limits.
- [Command bus, idempotency and audit trail](https://byteminus.github.io/laravel-ai-blog/docs/command-bus.md): Route every blog change through one command bus: abilities, validation, idempotency keys that replay retries, dry runs and an audit trail.
- [Laravel AI Blog FAQ](https://byteminus.github.io/laravel-ai-blog/docs/faq.md): Answers to every common question about Laravel AI Blog: installation, SEO scoring, AI drafting, the MCP server, routes, safe fetching and testing.
- [Full documentation in one file](https://byteminus.github.io/laravel-ai-blog/llms-full.txt): every page below concatenated

## Source

- [GitHub repository](https://github.com/byteminus/laravel-ai-blog): code, issues, releases
- [Packagist](https://packagist.org/packages/byteminus/laravel-ai-blog): `byteminus/laravel-ai-blog`

## Optional

- [Philosophy and roadmap](https://byteminus.github.io/laravel-ai-blog/docs/philosophy.md): Why Laravel AI Blog makes human writers faster instead of mass-producing posts, and what is planned next: sitemaps, embeddings, Filament.
- [Contributing to Laravel AI Blog](https://byteminus.github.io/laravel-ai-blog/docs/contributing.md): Set up Laravel AI Blog locally, run the tests and static analysis, and send a pull request. Good first issues are listed for most roadmap items.
- [Security policy](https://byteminus.github.io/laravel-ai-blog/docs/security.md): How to report a security vulnerability in Laravel AI Blog privately, and which versions receive security fixes.
- [Changelog](https://byteminus.github.io/laravel-ai-blog/docs/changelog.md): Every release of Laravel AI Blog with what changed: SEO tags, AI features, MCP tools, safe fetching and breaking changes.