=== Tin GEO ===
Contributors: tincomputer
Tags: seo, ai, llms-txt, robots, structured-data
Requires at least: 5.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your site discoverable to AI assistants and search engines, managed remotely by your Tin Computer growth agent.

== Description ==

Tin GEO gives your WordPress site the technical surface AI assistants read when they decide whether to recommend you, and lets the [Tin Computer](https://tin.computer) growth service manage it for you through the standard WordPress REST API:

* **robots.txt rules** — deliberate allows for AI crawlers (GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, Google-Extended) added to WordPress's virtual robots.txt.
* **llms.txt** — the AI-assistant index of your canonical pages, served at `/llms.txt` with a footer link.
* **Structured data** — site-wide and per-page JSON-LD (Organization, LocalBusiness, FAQPage, Article and friends).
* **Meta descriptions and OG tags** — only when no dedicated SEO plugin is active; if you run Yoast, All in One SEO, Rank Math, SEOPress or The SEO Framework, Tin GEO stays out of your head output.
* **Machine-readable pricing** — a `/pricing.json` file kept in sync with your real pricing.
* **One-time login links** — your connected Tin agent can mint a single-use, 5-minute, audit-logged wp-admin login link for the account that approved the connection, for the rare task the REST API cannot do. Disable entirely with `add_filter( 'tin_geo_enable_login_links', '__return_false' );`.

Everything is managed over the core REST API (namespace `tin/v1`), authenticated by the Application Password you approve in your own wp-admin, and restricted to administrators. Every remote change and every login link is recorded in an audit log you can read at any time (`GET /wp-json/tin/v1/audit`).

On WordPress 6.9+ the plugin also registers its operations with the Abilities API, so MCP-based AI clients can discover them as tools.

This plugin is a companion to the Tin Computer service ([terms](https://tin.computer/terms)). It works standalone — every feature above functions without a Tin account — but it is designed to be driven by Tin's agent.

== External services ==

The plugin makes exactly one kind of outbound request: it checks `https://tin.computer/wp/tin-geo.json` for plugin updates (standard WordPress update flow via the Update URI header). No content, analytics, or site data is sent to Tin Computer or anyone else by this plugin.

== Installation ==

1. Upload the plugin ZIP under Plugins → Add New → Upload Plugin, and activate it.
2. If you use Tin Computer, connect your site from your Tin dashboard — the agent takes it from there.
3. Without Tin, manage the documents over the REST API with any Application Password holding administrator rights.

== Frequently Asked Questions ==

= Does this replace my SEO plugin? =

No. When a dedicated SEO plugin is active, Tin GEO does not print meta descriptions or OG tags at all; robots.txt, llms.txt, pricing.json and JSON-LD blocks are additive.

= Can the login links be abused? =

A link can only be minted by an authenticated administrator REST call, only logs in as that same administrator, lasts 5 minutes, works once, and is stored hashed. Minting and use are both audit-logged. You can switch the feature off with one filter.

== Changelog ==

= 0.1.0 =
* Initial release: robots.txt rules, llms.txt, site + per-post JSON-LD, meta descriptions with SEO-plugin detection, pricing.json, status endpoint, audit log, one-time login links, Abilities API registration.
