=== MentionForge — AI Search Visibility ===
Contributors: dsweeneyjr
Tags: ai search, ai seo, generative search, website analysis, seo
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find out where you're losing visibility in AI search — and what to change.

== Description ==

MentionForge — AI Search Visibility helps WordPress site owners understand how their organization appears in AI-powered search and recommendation results.

Monitor real-world questions your customers, clients, students, or other audiences might ask an AI assistant. Compare your visibility with competitors, analyze your public website, and turn weak AI-search results into specific website improvements.

Instead of stopping at a visibility score, MentionForge can tell you:

* Which monitored prompts mention your organization.
* How your organization performs for each prompt.
* Which competitors appear in AI-generated answers.
* Which page on your website should be improved.
* What's missing from that page.
* What change to make.
* Suggested copy to help implement the recommendation.
* Why the change may improve your AI-search visibility.

The workflow is simple:

1. Configure your organization.
2. Add competitors.
3. Create real-world search prompts.
4. Run an AI Search Evaluation.
5. Scan your public website.
6. Generate page-specific recommendations.

Current features include:

* Organization profile and brand aliases.
* Competitor tracking.
* Prompt library with discovery, comparison, and branded prompts.
* Manual AI-search evaluations.
* Visibility scores and organization mention/ranking detection.
* AI response and source storage.
* Evaluation history.
* Public website sitemap discovery and page analysis.
* Page-specific action plans for prompts with weak visibility.
* Suggested website copy grounded in the scanned public website.
* Administrator-only configuration and actions.

MentionForge is currently designed for one organization per WordPress installation.

= AI provider requirements =

Version 1.0 uses OpenAI as its supported AI provider for evaluations and recommendation generation. These features require your own OpenAI API key. OpenAI API usage is billed separately by OpenAI according to your OpenAI account and usage.

Support for additional AI providers is planned for future releases.

Website Analysis itself scans the public website configured in the plugin and does not require an AI provider request.

== External Services ==

This plugin connects to the OpenAI API when an administrator explicitly initiates an AI-powered action after configuring an OpenAI API key.

Service: OpenAI

Service website: https://openai.com/

OpenAI Services Agreement: https://openai.com/policies/services-agreement/

OpenAI Privacy Policy: https://openai.com/policies/privacy-policy/

Data sent during an AI search evaluation:

* The search prompt configured by the administrator.
* API request configuration needed to generate the response.

Data sent while generating recommendations:

* The monitored search prompt.
* The stored AI evaluation response and visibility information.
* Organization information configured by the administrator.
* Selected text, page titles, headings, meta descriptions, and URLs from public pages scanned by Website Analysis.

The plugin does not automatically send this information merely because it is activated. AI requests occur when an administrator configures the service and initiates the relevant AI-powered action.

OpenAI API usage can incur charges on the administrator's OpenAI account.

== Source code ==

MentionForge ships its PHP, JavaScript, and CSS in human-readable source form. No build step is required to inspect, modify, or run the distributed plugin.

== Installation ==

1. Install MentionForge through the WordPress plugin directory, or upload the `mentionforge-ai-search-visibility` folder to `/wp-content/plugins/`.
2. Activate MentionForge — AI Search Visibility.
3. Open MentionForge > Organization and configure the organization and website.
4. Add relevant competitors.
5. Build the Prompt Library.
6. Open Settings and enter an OpenAI API key.
7. Run an AI Search Evaluation.
8. Run Website Analysis.
9. Open Recommendations and build the action plan.

== Frequently Asked Questions ==

= What is MentionForge? =

MentionForge is a WordPress plugin for monitoring how an organization appears in AI-powered search results and turning those results into specific website improvement recommendations.

= Which AI providers are supported? =

Version 1.0 supports OpenAI for AI search evaluations and recommendations. The site administrator supplies their own OpenAI API key, and OpenAI bills API usage separately. Support for additional AI providers is planned for future releases.

= Is MentionForge an SEO plugin? =

MentionForge focuses specifically on visibility in AI-generated search and recommendation results. It complements traditional SEO tools rather than replacing them.

= Can I track competitors? =

Yes. You can configure competitors and use comparison and discovery prompts to see how your organization appears alongside other organizations in AI-generated answers.

= Does the plugin run AI requests automatically? =

No. AI requests are initiated by an administrator from the plugin interface.

= What website content is scanned? =

Website Analysis discovers public URLs from the organization's sitemap and stores a text snapshot of a limited number of public pages in the WordPress database.

= Does Website Analysis scan other domains? =

No. Discovered and requested pages are restricted to the configured organization's hostname, and WordPress safe HTTP request handling is used.

= What is sent to OpenAI? =

Evaluation prompts are sent when an administrator runs an evaluation. Recommendation generation can additionally send selected content from scanned public website pages together with the relevant evaluation result and configured organization information. See the External Services section for details.

= Are recommendations automatically applied to my website? =

No. Recommendations are displayed for review. MentionForge does not automatically change public website content.

= Does MentionForge guarantee that my organization will appear in AI answers? =

No. AI-generated answers can vary between providers, models, searches, and over time. MentionForge provides visibility measurements and website recommendations but cannot guarantee inclusion or ranking in an AI-generated response.

= Can I track more than one organization? =

Version 1.0 is designed around one primary organization per WordPress installation.

== Screenshots ==

1. MentionForge dashboard showing the monitored organization, competitors, active prompts, AI evaluations, and recommended next actions.
2. Organization configuration for defining the organization, website, service area, description, and brand aliases MentionForge should monitor.
3. Competitor tracking for adding and managing organizations to compare against in AI-generated answers.
4. Prompt Library for creating and managing discovery, comparison, and branded questions used in AI-search evaluations.
5. AI Search Evaluations showing evaluation history, monitored prompts, and visibility scores.
6. Website Analysis showing public pages discovered and scanned to provide page-level recommendation context.
7. Recommendations showing the exact page to improve, what's missing, the recommended change, suggested copy, and why the change matters.

== Privacy ==

MentionForge — AI Search Visibility stores configuration, evaluations, scanned public website text, and generated recommendations in the site's WordPress database.

The plugin adds suggested disclosure text to WordPress's Privacy Policy Guide.

For AI-powered features, information is sent to OpenAI only when an administrator has configured an OpenAI API key and initiates an AI-powered action. Review the External Services section above and OpenAI's applicable terms before using those features.

== Support ==

For product information, documentation, and support information, visit:

https://davidjsweeney.com/mentionforge/

== Changelog ==

= 1.0.0 =

* Initial public release.
* Added organization and competitor configuration.
* Added prompt library and AI search evaluations.
* Added evaluation progress and error handling.
* Added Website Analysis with sitemap discovery and page scanning.
* Added definitive page-level recommendations and suggested copy.
* Added external-service and privacy disclosures.
* Hardened public website fetching and organization-domain restrictions.
* Added uninstall cleanup.