# Changelog
Source: https://docs.naridon.com/changelog

Latest product updates and improvements

<Update label="April 2026" description="MCP Server v0.4.0 — Zero-config install">
  ## Naridon MCP Server v0.4.0

  Use Naridon directly from Claude Code, Cursor, Windsurf, Claude Desktop, or any MCP-compatible AI assistant — with a one-command install.

  ### One-line install

  ```bash theme={null}
  npx @naridon/mcp-server install
  ```

  The installer detects your AI tools, signs you in via browser, and writes the config files for you. Supports both **global** (use everywhere) and **project** scope.

  ### No more `shopId`

  Tools that used to require a `shopId` argument now resolve it automatically from your API key. The LLM never has to guess which shop you're working with — `whoami` reports it explicitly.

  ### Per-shop API keys

  Generate scoped, revocable keys from **Settings → API Keys**. Pick exactly which permissions a key gets (read-only, write-fixes, trigger-scans, etc.).

  ### LLM-readable errors

  Every error from the server is written for an AI to read and self-correct. 401, 403, 404, 429, and network errors all include the exact next step.

  ### New tools

  * `whoami` — identity context for the current key
  * `list_shops` — all shops accessible from a multi-shop key

  See the new [MCP integration docs](/integrations/mcp).
</Update>

<Update label="December 2025" description="v2.0 - The Intelligence Update">
  ## New Core Features

  ### 🤖 Copilot & Knowledge Base

  We've introduced the **Copilot** module, allowing you to train a custom AI agent on your store data.

  * **Knowledge Base**: Now indexes Collections, Blog Posts, and Custom Articles.
  * **Conversations**: Handle customer queries with a brand-aware AI.

  ### 👁️ Vision AI Alt Text

  The **Fix Engine** (now under *Improve*) has been upgraded with Vision AI capabilities.

  * Uses **GPT-4o** and **Claude 3.5 Sonnet** to analyze product images.
  * Automatically generates descriptive, SEO-optimized Alt Text.

  ### 📊 Global Visibility Score

  We've revamped how we measure success.

  * **Share of Voice**: New metric tracking your presence relative to competitors.
  * **Global Score**: A unified 0-100 score reflecting your top-5 ranking frequency.

  ## Technical Improvements

  * **New Models**: Added support for **DeepSeek V3**, **Gemini 2.0 Flash Exp**, and **GPT-4o Realtime Preview**.
  * **Onboarding**: Streamlined 3-step wizard with "Silent Scan" technology.
  * **Settings**: Added "Zero-Click Execution" for safe, automated fixes.
</Update>

<Update label="November 2025" description="v1.5 - The Analytics Update">
  ## Features

  * **ROI Calculator**: Estimate revenue uplift from AI traffic.
  * **Traffic Attribution**: Detailed breakdown of visits from ChatGPT, Perplexity, and Claude.
  * **Schema Injector**: Automated JSON-LD injection for Products and Brands.
</Update>

<Update label="October 2025" description="v1.0 - Initial Launch">
  ## Launch

  * **AIO Engine**: Core optimization for LLMs.
  * **Competitor War Room**: Track ranking against rivals.
  * **Fix Engine**: Basic schema repair and description improvements.
</Update>


# Acceptable Use Policy
Source: https://docs.naridon.com/compliance/acceptable-use

Rules and restrictions for using the Naridon platform

## 1. Introduction

This Acceptable Use Policy (AUP) outlines the prohibited uses of the Naridon platform. By using our services, you agree to comply with this policy.

## 2. Prohibited Content

You may not use Naridon to generate, host, or promote content that:

* Is illegal, harmful, or fraudulent.
* Infringes on the intellectual property rights of others.
* Contains hate speech, harassment, or threats of violence.
* Promotes self-harm or illegal acts.
* Contains sexually explicit material or child exploitation.

## 3. Prohibited Actions

You agree not to:

* **Reverse Engineer**: Attempt to reverse engineer, decompile, or discover the source code or underlying algorithms of the Service.
* **Scrape**: Use automated systems (bots, spiders) to scrape data from our platform without permission.
* **Interfere**: Disrupt the integrity or performance of the Service or third-party data contained therein.
* **Bypass**: Attempt to bypass or circumvent any security measures or usage limits (e.g., API rate limits).

## 4. AI Interaction Standards

When using our AI features, you must not:

* Use the AI to generate misleading or deceptive content.
* Attempt to "jailbreak" or override the safety guardrails of the underlying AI models.
* Use the AI to provide medical, legal, or financial advice where professional certification is required.

## 5. Enforcement

We reserve the right to investigate any violation of this policy. If we determine that you have violated this AUP, we may:

* Remove offending content.
* Suspend or terminate your access to the Service.
* Report unlawful conduct to law enforcement authorities.

## 6. Reporting Violations

If you become aware of any violation of this policy, please report it to us immediately at [support@naridon.com](mailto:support@naridon.com).


# Cookie Policy
Source: https://docs.naridon.com/compliance/cookie-policy

How we use cookies and tracking technologies

## 1. What are cookies?

Cookies are small text files that are stored on your computer or mobile device when you visit a website. They are widely used to make websites work more efficiently and provide information to the owners of the site.

## 2. How We Use Cookies

Naridon uses cookies to:

* **authenticate** your identity when you log in to the dashboard.
* **remember** your preferences and settings.
* **analyze** how our app is used to improve performance and user experience.
* **secure** our services against fraud and abuse.

## 3. Types of Cookies We Use

### Essential Cookies

These are necessary for the app to function. Without them, we cannot provide the service (e.g., session cookies for login).

### Analytics Cookies

We use these to understand how visitors interact with our documentation and app. The data is aggregated and anonymous.

### Functionality Cookies

These allow us to remember choices you make (such as your preferred language or region) and provide enhanced features.

## 4. Managing Cookies

Most web browsers allow you to control cookies through their settings preferences. However, if you limit the ability of websites to set cookies, you may worsen your overall user experience, since it will no longer be personalized to you. It may also stop you from saving customized settings like login information.

## 5. Third-Party Cookies

In some special cases, we also use cookies provided by trusted third parties, such as:

* **Google Analytics** (for usage statistics)
* **Intercom / Support Chat** (for customer support sessions)

## 6. Updates to this Policy

We may update this Cookie Policy from time to time. We encourage you to review this page periodically for the latest information on our privacy practices.


# GDPR & Data Security
Source: https://docs.naridon.com/compliance/gdpr

Comprehensive details on data protection, encryption, and EU compliance

## 1. Commitment to Data Privacy

Naridon, operated by **Thom & Co GmbH** (Switzerland), is fully committed to compliance with the **General Data Protection Regulation (GDPR)** and the **Swiss Federal Act on Data Protection (FADP)**. We prioritize the security and privacy of both our Merchants and their End-Customers.

## 2. Roles & Responsibilities

It is crucial to understand our role in processing data:

* **Merchant Data**: When you (the merchant) install Naridon, we act as a **Data Controller** for your account information (name, email, billing details).
* **End-Customer Data**: When we process your store's customer queries or search history, we act as a **Data Processor**. You remain the **Data Controller**. We process this data solely on your instructions.

## 3. Lawful Basis for Processing

We process personal data only when we have a lawful basis to do so, in accordance with Article 6 GDPR.

| Data Type                     | Purpose                                                                 | Lawful Basis                                                       |
| :---------------------------- | :---------------------------------------------------------------------- | :----------------------------------------------------------------- |
| **Account Information**       | To provide the Naridon App service, manage billing, and authentication. | **Contractual Necessity** (Art. 6(1)(b))                           |
| **Product Data**              | To index and optimize your store's catalog for AI models.               | **Contractual Necessity** (Art. 6(1)(b))                           |
| **Customer Queries (Search)** | To provide AI search results and analytics to the merchant.             | **Legitimate Interest** (Art. 6(1)(f)) & **Contractual Necessity** |
| **Usage Logs**                | To ensure security, debug issues, and improve app performance.          | **Legitimate Interest** (Art. 6(1)(f))                             |
| **Marketing Comms**           | To send product updates or offers.                                      | **Consent** (Art. 6(1)(a))                                         |

## 4. International Data Transfers

As a modern SaaS application, we utilize cloud infrastructure that may be located outside of Switzerland/EU (specifically the USA). To ensure your data remains protected, we rely on the following safeguards:

* **Adequacy Decisions**: For transfers to countries recognized by the EU/Switzerland as providing adequate protection.
* **Standard Contractual Clauses (SCCs)**: For transfers to providers in the USA (e.g., OpenAI, Supabase), we enter into DPA agreements incorporating the standard contractual clauses approved by the European Commission.
* **Data Privacy Framework**: Where applicable, we prioritize vendors participating in the EU-U.S. Data Privacy Framework.

## 5. Sub-Processors

We use the following third-party sub-processors to provide our service.

| Sub-Processor      | Role                           | Location                   | Safeguard       |
| :----------------- | :----------------------------- | :------------------------- | :-------------- |
| **Shopify**        | E-commerce Platform & Identity | Canada (Adequate) / Global | Adequacy / SCCs |
| **Vercel Inc.**    | Cloud Hosting & Edge Functions | USA                        | SCCs            |
| **Supabase Inc.**  | Database & Vector Storage      | USA (AWS East)             | SCCs            |
| **OpenAI, LLC**    | LLM Inference (Zero Retention) | USA                        | SCCs            |
| **Anthropic, PBC** | LLM Inference (Zero Retention) | USA                        | SCCs            |

*Note: We have signed specific "Zero Data Retention" agreements with our AI providers where available, ensuring they do not use your data to train their models.*

## 6. Data Subject Rights

Under GDPR, you (and your customers) have the following rights:

1. **Right of Access**: Request a copy of the personal data we hold about you.
2. **Right to Rectification**: Request correction of inaccurate or incomplete data.
3. **Right to Erasure ("Right to be Forgotten")**: Request deletion of your personal data, subject to legal retention obligations.
4. **Right to Restriction**: Request that we restrict the processing of your data.
5. **Right to Data Portability**: Request your data in a structured, commonly used format.
6. **Right to Object**: Object to processing based on legitimate interests.

To exercise these rights, please contact our Data Protection Officer at **[privacy@naridon.com](mailto:privacy@naridon.com)**.

## 7. Technical & Organizational Measures (TOMs)

We implement state-of-the-art security measures to protect data:

### Encryption

* **In Transit**: TLS 1.2+ encryption for all data moving between Shopify, our servers, and the client.
* **At Rest**: AES-256 encryption for all database volumes and backups.

### Access Control

* **Role-Based Access**: Internal access is restricted to engineering staff with a specific business need.
* **MFA**: Multi-Factor Authentication is enforced for all administrative access.

### Availability & Resilience

* **Backups**: Automated daily backups with point-in-time recovery.
* **Redundancy**: Critical services are deployed across multiple availability zones.

## 8. Data Breach Notification

In the event of a personal data breach, we will notify:

* The competent supervisory authority within **72 hours**, unless the breach is unlikely to result in a risk to rights and freedoms.
* Affected controllers (Merchants) without undue delay, providing sufficient information to allow you to meet your own notification obligations.

## 9. Contact Information

**Data Protection Officer (DPO)**
Thom & Co GmbH
Scherzingerstasse 16, 8598 Bottighofen, Switzerland
Email: [privacy@naridon.com](mailto:privacy@naridon.com)


# Imprint
Source: https://docs.naridon.com/compliance/imprint

Legal notice and company information

## Legal Operator

**Thom & Co GmbH**
Scherzingerstasse 16
8598 Bottighofen
Switzerland

## Contact

* **Email**: [info@thomco.ch](mailto:info@thomco.ch)
* **Phone**: +41 44 586 05 25
* **App Support**: [support@naridon.com](mailto:support@naridon.com)

## Authorized Representatives

**Carolin Thom**
Managing Director

## Commercial Register

* **Registered Company Name**: Thom & Co GmbH
* **Number**: CHE-273.347.179
* **VAT Number**: CHE-273,347,179

## Regulatory Information

* **Dispute Resolution**: The European Commission provides a platform for online dispute resolution (OS): [http://ec.europa.eu/consumers/odr](http://ec.europa.eu/consumers/odr). We are not obligated to participate in dispute resolution proceedings before a consumer arbitration board.

## Copyright & Liability

All content, branding, and trademarks associated with Naridon are the property of their respective owners. Despite careful content control, we assume no liability for the content of external links. The operators of linked pages are solely responsible for their content.


# Privacy Policy
Source: https://docs.naridon.com/compliance/privacy

Detailed information on data collection, processing, and user rights

**Last Updated**: December 4, 2025

## 1. Introduction

This Privacy Policy describes how **Thom & Co GmbH** ("Naridon", "we", "us", or "our") collects, uses, and discloses your Personal Data when you visit our website, install our Shopify Application, or use our services (collectively, the "Service").

We are committed to protecting your privacy in accordance with the **EU General Data Protection Regulation (GDPR)** and the **Swiss Federal Act on Data Protection (FADP)**.

## 2. Information We Collect

### A. Information You Provide to Us

* **Account Information**: When you install Naridon, we collect your name, email address, and shop URL via Shopify's API.
* **Support Communications**: Information you provide when contacting our support team (email content, screenshots).
* **Configuration Data**: Settings and preferences you input into the Naridon dashboard (e.g., target keywords, brand guidelines).

### B. Information We Collect Automatically

* **Log Data**: We collect server logs which may include IP addresses, browser type, operating system, and timestamps.
* **Usage Data**: We track how you interact with the dashboard (pages visited, features used) to improve user experience.
* **Store Data**: We index public product information (titles, descriptions, images) to power the AI search features.

### C. Information Processed on Behalf of Merchants

When you use Naridon on your store, we may process personal data of your customers ("End-Users") on your behalf:

* **Search Queries**: Questions asked by customers to the AI.
* **Session Metadata**: Anonymous session IDs to group interactions.
  *Note: We do NOT collect or store sensitive payment information (credit cards) or passwords.*

## 3. How We Use Your Information

We use your Personal Data for the following purposes:

1. **Service Delivery**: To provide the functionality of the Naridon App (contractual necessity).
2. **Billing & Administration**: To manage your subscription and communicate service updates (contractual necessity).
3. **Security & Debugging**: To detect and prevent fraud, abuse, or technical issues (legitimate interest).
4. **Product Improvement**: To analyze usage patterns and train our search algorithms (legitimate interest).
5. **Marketing**: To send you promotional content, where you have opted in (consent).

## 4. Data Sharing and Disclosure

We do not sell your Personal Data. We share data only in the following circumstances:

* **Service Providers**: With trusted third-party sub-processors (hosting, AI, analytics) who assist us in operating the Service. These transfers are covered by Data Processing Agreements (DPAs).
* **Legal Compliance**: If required by law, subpoena, or legal process.
* **Business Transfers**: In connection with a merger, sale, or asset transfer, provided the receiving party agrees to privacy terms.

## 5. Data Retention

We retain Personal Data only for as long as necessary:

* **Merchant Account Data**: Retained for the duration of your subscription plus 2 years for tax/legal records.
* **End-User Search Logs**: Retained for **30 days** for analytics, then anonymized or deleted.
* **Backups**: Retained for **90 days** in encrypted archives.

## 6. Cookies and Tracking

We use cookies to authenticate sessions and analyze traffic. You can control cookies through your browser settings.

* **Essential Cookies**: Required for login (e.g., Shopify Session Tokens).
* **Analytics Cookies**: Used to measure site performance (can be opted out).
  For more details, please see our [Cookie Policy](/compliance/cookie-policy).

## 7. Your Rights (GDPR/FADP)

If you are located in the EEA, UK, or Switzerland, you have the right to:

* Access, correct, or delete your personal data.
* Restrict or object to our processing.
* Withdraw consent at any time (for marketing).
* Lodge a complaint with a supervisory authority.

**Merchants**: You can access/delete your data directly via the Shopify Admin (App Uninstall triggers data cleanup).
**End-Customers**: Please contact the Merchant directly. As a Processor, we will assist the Merchant in fulfilling these requests.

## 8. Contact Us

If you have questions about this policy or wish to exercise your rights, please contact:

**Thom & Co GmbH**
Privacy Team
Scherzingerstasse 16, 8598 Bottighofen, Switzerland
Email: [privacy@naridon.com](mailto:privacy@naridon.com)


# Service Level Agreement
Source: https://docs.naridon.com/compliance/sla

Our commitment to uptime and reliability

## 1. Uptime Commitment

Naridon is committed to providing a reliable service. We aim to maintain a Service Availability of at least **99.9%** during any monthly billing cycle.

## 2. Service Availability Definition

**"Service Availability"** is calculated as the total number of minutes in a calendar month minus the number of minutes of Unavailability, divided by the total number of minutes in the calendar month.

**"Unavailability"** means that the Naridon App or API is inaccessible to the Customer or is unable to process requests.

Unavailability **excludes** issues caused by:

* Scheduled maintenance (with prior notice).
* Factors outside our reasonable control (Force Majeure events).
* Failures of the Shopify platform or third-party AI providers (e.g., OpenAI/Anthropic outages).
* Customer's equipment, software, or network connections.

## 3. Scheduled Maintenance

We perform regular maintenance to ensure the security and performance of the platform.

* We aim to schedule maintenance during off-peak hours (typically weekends or late night UTC).
* We will provide at least 24 hours' notice for any scheduled maintenance that is expected to cause downtime.

## 4. Support Response Times

While not a guarantee of resolution, we aim to respond to support inquiries within the following timeframes:

| Priority   | Description                                            | Target Response Time |
| :--------- | :----------------------------------------------------- | :------------------- |
| **Urgent** | Service is down or critical features are unusable.     | \< 4 Hours           |
| **High**   | Significant feature degradation but workaround exists. | \< 24 Hours          |
| **Normal** | General questions, feature requests, or minor bugs.    | \< 48 Hours          |

## 5. SLA Credits

This SLA is a policy statement and does not automatically grant financial credits for downtime unless explicitly specified in a customized Enterprise Enterprise agreement.

For standard plans, significant downtime may be compensated with service credits at our sole discretion. Please contact support if you believe you have been affected by extended unavailability.


# Terms of Service
Source: https://docs.naridon.com/compliance/terms

Terms and conditions for using Naridon (Thom & Co GmbH)

**Last Updated**: December 4, 2025

## 1. Introduction

These Terms of Service ("Terms") govern your use of the Naridon Shopify Application ("Service") provided by **Thom & Co GmbH**, a company registered in Switzerland ("Naridon", "we", "us").

By installing or using the Service, you agree to these Terms. If you are entering into these Terms on behalf of a company, you represent that you have the authority to bind that entity.

## 2. Service Description

Naridon provides AI-powered search optimization and analytics tools for Shopify merchants. The Service includes:

* Data indexing and optimization.
* AI content generation (suggestions for products).
* Analytics dashboards.

## 3. Account & Eligibility

* **B2B Service**: The Service is intended for use by businesses (merchants) only, not consumers.
* **Shopify Account**: You must have an active Shopify store to use Naridon.
* **Security**: You are responsible for maintaining the security of your login credentials.

## 4. Subscription & Billing

* **Shopify Billing**: All fees are billed through the Shopify Billing API. You agree to pay the fees applicable to your selected plan.
* **Changes**: We reserve the right to change pricing with 30 days' notice.
* **Refunds**: As a general policy, we do not offer refunds for partial months. Exceptions may be made at our sole discretion or as required by Shopify's partner terms.

## 5. Intellectual Property

* **Your Data**: You retain all rights to your store data (products, images, content). You grant us a worldwide, royalty-free license to access, store, and process this data solely to provide the Service.
* **Naridon IP**: We retain all rights to the Service, including code, algorithms, and designs. You may not reverse engineer or copy the Service.
* **AI Output**: You own the specific output generated for your store (e.g., optimized descriptions), subject to the terms of our underlying AI providers.

## 6. Data Protection

Our use of your personal data is governed by our [Privacy Policy](/compliance/privacy) and [GDPR Statement](/compliance/gdpr). By using the Service, you agree to the terms of our **Data Processing Agreement (DPA)**, which is incorporated by reference for all merchants subject to GDPR.

## 7. Warranties & Disclaimers

**"As Is"**: The Service is provided "as is" without warranties of any kind, whether express or implied.
**AI Disclaimer**: The Service uses Artificial Intelligence, which may occasionally produce incorrect or "hallucinated" results. You are responsible for reviewing all AI-generated content before publishing it to your store. We do not guarantee specific SEO rankings or sales results.

## 8. Limitation of Liability

To the fullest extent permitted by applicable law (Switzerland):

* **Indirect Damages**: We shall not be liable for any indirect, incidental, special, or consequential damages (including loss of profits or data).
* **Cap**: Our total liability for any claim arising out of these Terms shall not exceed the amount you paid us in the **12 months** preceding the claim.
* **Exclusions**: Nothing in these Terms limits liability for intent, gross negligence, or death/personal injury caused by negligence.

## 9. Governing Law & Jurisdiction

* **Governing Law**: These Terms are governed by the substantive laws of **Switzerland**, excluding its conflict of laws principles.
* **Jurisdiction**: The exclusive place of jurisdiction for all disputes is **Bottighofen, Switzerland**, unless mandatory law provides otherwise.

## 10. Modifications

We may modify these Terms at any time. We will notify you of material changes via email or within the App. Continued use of the Service constitutes acceptance of the new Terms.

## 11. Contact

**Thom & Co GmbH**
Scherzingerstasse 16, 8598 Bottighofen, Switzerland
Email: [support@naridon.com](mailto:support@naridon.com)


# Contact Us
Source: https://docs.naridon.com/contact

Get in touch with the Naridon team

## Support Channels

We are here to help you get the most out of Naridon. Whether you have a question about features, pricing, or need technical assistance, feel free to reach out.

### Email Support

For general inquiries and technical support, please email us at:
**[support@naridon.com](mailto:support@naridon.com)**

We typically respond within 24 hours on business days.

### Privacy & Data

For questions related to GDPR, data privacy, or security, please contact our Data Protection Officer:
**[privacy@naridon.com](mailto:privacy@naridon.com)**

## Social Media

Follow us for the latest updates, feature releases, and e-commerce tips.

<CardGroup>
  <Card title="Twitter / X" icon="twitter" href="https://twitter.com/naridon">
    Follow us @naridon for real-time updates.
  </Card>

  <Card title="LinkedIn" icon="linkedin" href="https://linkedin.com/company/naridon">
    Connect with us for company news and articles.
  </Card>
</CardGroup>

## Feature Requests

Have an idea for a new feature? We'd love to hear it! Please send your suggestions to [support@naridon.com](mailto:support@naridon.com) with the subject line "Feature Request".


# FAQ
Source: https://docs.naridon.com/faq

Frequently asked questions about Naridon

## General

<AccordionGroup>
  <Accordion title="What is the difference between SEO and AIO?">
    **SEO (Search Engine Optimization)** helps you rank for keywords in traditional search engines like Google.

    **AIO (AI Search Optimization)** helps you rank for *conversations* in AI models like ChatGPT, Claude, and Perplexity. When a user asks an AI for a recommendation, AIO ensures your product is the answer.
  </Accordion>

  <Accordion title="Does Naridon affect my store's speed?">
    **No.** Naridon runs on its own infrastructure (Vercel/AWS) and connects to your store via the Shopify API. It does not inject heavy scripts into your storefront theme, so it has zero impact on your site loading speed.
  </Accordion>

  <Accordion title="How long does it take to see results?">
    AI models update their knowledge at different rates.

    * **Real-time models** (Perplexity, Bing Chat, Google Gemini) can reflect changes within **24-48 hours**.
    * **Static models** (older GPT versions) may take weeks to update.

    Generally, our users see their first "AI Traffic" spikes within 14 days of optimizing their schema and content.
  </Accordion>
</AccordionGroup>

## Pricing & Plans

<AccordionGroup>
  <Accordion title="Is there a free trial?">
    Yes! We offer a **14-day free trial** on all paid plans. You can also use our **Free Plan** indefinitely, which allows you to track 5 prompts and fix 20 products per month.
  </Accordion>

  <Accordion title="Can I cancel anytime?">
    Yes. You can cancel your subscription at any time directly from the Shopify App dashboard. There are no long-term contracts.
  </Accordion>

  <Accordion title="Do you offer enterprise plans?">
    Yes. For merchants with over 10,000 products or custom API needs, we offer an **Enterprise Plan** with dedicated support and higher limits. Please [contact support](/contact) for details.
  </Accordion>
</AccordionGroup>

## Safety & Data

<AccordionGroup>
  <Accordion title="Is my data shared with other merchants?">
    **Never.** Your data is isolated and encrypted. We do not share your sales data or product strategies with other merchants.
  </Accordion>

  <Accordion title="Does Naridon use my data to train public AI models?">
    **No.** We use enterprise APIs from OpenAI and Anthropic with "Zero Data Retention" policies. This means your data is used *only* to generate answers for you and is not used to train their public models.
  </Accordion>

  <Accordion title="Will the AI hallucinate about my products?">
    We use a technique called **RAG (Retrieval-Augmented Generation)** which grounds the AI in your actual product data. While no AI is 100% perfect, this drastically reduces the chance of hallucinations. You also have full control to review and edit any content before it goes live.
  </Accordion>
</AccordionGroup>

## Technical

<AccordionGroup>
  <Accordion title="What happens if I uninstall the app?">
    If you uninstall Naridon:

    1. Your subscription is immediately cancelled.
    2. Your data is deleted from our servers in accordance with our [Privacy Policy](/compliance/privacy).
    3. Any changes you *published* to your store (like improved descriptions or schema) **remain** on your store. They are yours to keep!
  </Accordion>

  <Accordion title="Do you support multi-language stores?">
    Yes. Naridon supports indexing and optimizing content for multiple languages. You can configure your target language in the **Settings** menu.
  </Accordion>
</AccordionGroup>


# AIO Engine
Source: https://docs.naridon.com/features/aio-engine

Optimize your store for the new era of AI Search

## What is the AIO Engine?

The **AIO (AI Search Optimization) Engine** is the core of Naridon. It ensures your products are discovered, understood, and recommended by modern AI models.

## Supported AI Models

Naridon optimizes your visibility across the leading AI platforms. We actively track and emulate:

* **OpenAI**: ChatGPT (GPT-4o)
* **Anthropic**: Claude (3.5 Sonnet)
* **Google**: Gemini (2.0 Flash)
* **Perplexity**: Online Search
* **Meta**: Llama 3
* **DeepSeek**: DeepSeek V3 Chat

## Global Visibility Score

Your **Global Visibility Score (0-100)** is the primary metric for your store's AI health. It is calculated based on:

1. **Top 5 Appearance**: The percentage of your tracked prompts where your brand appears in the top 5 suggestions.
2. **Share of Voice**: Your market presence compared to tracked competitors.

## Key Capabilities

### 1. Advanced Data Structuring

Naridon builds a rich, structured data layer for your store. We now index **Products**, **Collections**, and **Blog Posts** to give AI models a complete context of your business.

### 2. Prompt Monitoring

Track specific, high-intent user queries.

* **Silent Scan**: During onboarding, we automatically identify high-value prompts relevant to your niche.
* **Analysis Runs**: We use **DeepSeek V3** and **Gemini 2.0 Flash** to perform cost-effective, high-frequency analysis of your ranking.

### 3. Competitor Intelligence

Analyze how your competitors are being recommended.

* **Benchmarking**: Compare your Share of Voice against key competitors.
* **Strategy Adjustments**: Adjust your store's data signals to outrank competitors.


# Analytics
Source: https://docs.naridon.com/features/analytics

Measure the impact of AI on your bottom line

## ROI Calculator

Understanding the return on investment from AI optimization is crucial. Naridon's new **ROI Calculator** estimates the revenue uplift generated specifically from AI-referred traffic.

### Estimated Conversion Rate

We analyze the traffic sources identified as "AI Chatbots" and apply an estimated conversion rate to calculate your potential revenue gain from improved visibility.

## Key Metrics

### 1. Share of Voice

This is your primary competitive metric. It represents the percentage of the market (tracked prompts) where your brand appears in the conversation compared to your competitors.

### 2. Product Gaps

A health metric showing the number of products in your store that are missing critical metadata:

* Missing Descriptions
* Missing Alt Text
* Invalid Schema

### 3. Traffic Attribution

Naridon uses advanced tracking to identify visits from:

* **DeepSeek**
* **ChatGPT**
* **Perplexity**
* **Claude**

## Reporting

* **Weekly AI Visibility Report**: Get a summary of your Share of Voice and new ranking opportunities delivered to your email.


# Competitor Intelligence
Source: https://docs.naridon.com/features/competitors

Monitor your "Share of Voice" against rivals in AI search

## Competitive Intelligence

Naridon helps you understand how you compare to competitors in AI search results and identify opportunities to improve your visibility.

## Key Metrics

Track your performance relative to competitors across different metrics and time periods.

## Competitor Tracking

Naridon automatically identifies and tracks competitors based on your product category and search results.

## Intelligence Alerts

Receive real-time alerts about market shifts, competitor activity, and opportunities to improve your ranking.

## Taking Action

Use the insights to identify gaps and apply fixes to improve your competitive position.


# Copilot & Knowledge Base
Source: https://docs.naridon.com/features/copilot

Train your custom AI agent to manage customer conversations

## What is Copilot?

The **Copilot** is your store's dedicated AI agent. Unlike generic chatbots, Copilot is trained on your specific store data, policies, and brand voice. It powers the "Conversations" you see in the dashboard and can be used to simulate customer interactions or assist your support team.

## Knowledge Base

The Knowledge Base is the brain of your Copilot. It aggregates data from multiple sources to create a complete understanding of your business.

### Data Sources

Naridon automatically indexes:

* **Products**: Full catalog details (titles, prices, specs).
* **Collections**: To understand site structure and product categorization.
* **Blog Posts**: Articles and guides are indexed to answer "how-to" questions.
* **Custom Knowledge**: You can manually add specific articles (e.g., "Return Policy," "Brand History") to train the Copilot on non-product information.

## Skills

Skills are specific capabilities enabled for your Copilot.

* **Product Recommendation**: Ability to suggest products based on complex user needs.
* **Policy Answers**: Ability to quote or summarize return/shipping policies.
* **Voice Navigator**: Powered by **GPT-4o Realtime Preview**, allowing for voice-based interactions (if enabled).

## Supported Models

The Copilot leverages a hybrid model approach for optimal speed and reasoning:

* **Claude 3.5 Sonnet**: For complex reasoning and "Fix" generation.
* **Gemini 2.0 Flash Exp**: For ultra-fast text generation and summaries.
* **DeepSeek V3**: For high-volume analysis and cost-effective processing.


# Improve (Fix Engine)
Source: https://docs.naridon.com/features/fix-engine

Automated content optimization and technical repairs

## The "Improve" Module

The **Improve** tab is your home for optimization. It houses the **Fix Engine**, which performs daily automated scans to ensure your data meets the strict standards of AI models.

## New Fix Types

Naridon now supports a wider range of optimizations:

### 1. Vision AI Alt Text

Using **GPT-4o** and **Claude 3.5 Sonnet**, Naridon analyzes your product images pixel-by-pixel to generate descriptive, context-aware Alt Text.

* **Benefit**: Helps AI models "see" your products and improves accessibility.

### 2. Schema Injector

We automatically generate and inject **JSON-LD Structured Data** for:

* **Products**: Price, availability, ratings.
* **Brands**: Logo, description, social links.
* **Offers**: Merchant listings and shipping details.

### 3. Meta Tag Optimization

Naridon rewrites your SEO Title and Meta Descriptions to be more conversational and "clickable" for AI search results.

## Optimization Workflow

1. **Review Opportunities**: In the **Improve** tab, see a prioritized list of "Product Gaps".
2. **Generate Fix**: Click to have the AI draft a new description, alt text, or schema.
3. **Publish**:
   * **Manual**: Review the draft and click "Publish".
   * **Auto-Pilot**: If enabled (Balanced/Aggressive mode), safe fixes are applied automatically.

## Daily Limits

Depending on your plan, you have a specific "Fix Volume" per month (e.g., 100 for Starter, 500 for Growth). You can set a daily limit in Settings to spread these out.


# Configuration
Source: https://docs.naridon.com/features/settings

Manage global settings, automation levels, and your AI Sitemap

## Automation Settings (Auto-Pilot)

Control how autonomously Naridon improves your store data. You can find these settings in the **Improve** tab.

### Autonomy Levels

| Level            | Description                                                                                                      |
| :--------------- | :--------------------------------------------------------------------------------------------------------------- |
| **Conservative** | **Suggest Only**. Naridon generates fixes but waits for your approval. Best for starting out.                    |
| **Balanced**     | **Hybrid**. Safe fixes (like empty fields) are applied automatically; complex changes require review.            |
| **Aggressive**   | **Full Auto**. Prioritizes maximum visibility growth. Automatically applies optimized descriptions and alt text. |

### Execution Controls

* **Zero-Click Execution**: Toggle to allow "Safe Fixes" (e.g., filling missing alt text) to run without manual approval, regardless of mode.
* **Daily Fix Limit**: Set a cap on the number of products processed per day (Default: 5 for Starter plans).

## AI Sitemap (llms.txt)

Naridon generates a specialized `llms.txt` file for your store. This file guides AI crawlers (like OpenAI and Anthropic) on how to index your site.

### Custom Brand Guidelines

You can inject specific "System Instructions" into your `llms.txt` file.

> *Example: "We are a sustainable brand using 100% recycled materials. Emphasize our eco-friendly packaging in all product summaries."*

This ensures that when AI models crawl your site, they absorb your core brand values alongside your product data.

## Language Support

Naridon supports multi-language indexing. While the dashboard defaults to **en-US**, our database stores locale-specific data. You can specify your target language in the prompt settings to ensure the AI optimizes for your local market.


# Introduction
Source: https://docs.naridon.com/index

Welcome to Naridon - The AI Search Optimization (AIO) Platform for Shopify

<img alt="Hero Light" />

<img alt="Hero Dark" />

## What is Naridon?

Naridon is the first **AI Search Optimization (AIO)** platform designed specifically for Shopify stores.

While traditional SEO helps you rank for keywords in Google Search, **AIO helps you rank for conversations** in AI models like ChatGPT, Perplexity, Claude, and Gemini.

### The Shift: Keywords to Conversations

Shoppers are no longer just typing "red running shoes" into a search bar. They are asking AI assistants:

> *"I need a pair of running shoes for flat feet that are sustainable and under \$150. What do you recommend?"*

Naridon ensures **your** products are the answer to these questions.

## The Naridon Platform

Naridon is built around three core workflows:

<CardGroup>
  <Card title="Monitor" icon="chart-radar" href="/features/analytics">
    Track your **Share of Voice** and see where you rank in AI conversations.
  </Card>

  <Card title="Improve" icon="wrench" href="/features/fix-engine">
    Automatically fix **Schema**, **Alt Text**, and **Descriptions** with Vision AI.
  </Card>

  <Card title="Copilot" icon="robot" href="/features/copilot">
    Train a custom AI agent on your store data to handle customer **Conversations**.
  </Card>
</CardGroup>

## Why Now?

AI Search is the biggest shift in e-commerce since the invention of the search engine.

* **First Mover Advantage**: Establish authority with LLMs now to dominate recommendations for years.
* **High Intent**: Users asking specific questions are further down the funnel and ready to buy.
* **Organic Growth**: A sustainable traffic source that doesn't rely on rising ad costs.


# Naridon MCP Server
Source: https://docs.naridon.com/integrations/mcp/index

Use Naridon directly from Claude Code, Cursor, Windsurf, Claude Desktop, or any MCP-compatible AI assistant.

The **Naridon MCP server** exposes 45 tools for AI visibility, optimization, content management, and the Naridon Shop catalog — usable from any AI tool that speaks the [Model Context Protocol](https://modelcontextprotocol.io).

Once connected, you can ask your AI tool things like:

* *"What's my current visibility score?"*
* *"Show me pending optimization fixes and apply the safe ones."*
* *"Create a blog post about our new product launch and publish it."*
* *"Run a fresh scan and report what changed."*
* *"What content gaps do I have compared to competitors?"*

<CardGroup>
  <Card title="Quickstart" icon="rocket" href="/integrations/mcp/quickstart">
    Get connected in under 60 seconds with one command.
  </Card>

  <Card title="Manual setup" icon="gear" href="/integrations/mcp/manual-setup">
    Edit your AI tool's MCP config by hand.
  </Card>

  <Card title="Tools reference" icon="wrench" href="/integrations/mcp/tools-reference">
    Every tool the server exposes, grouped by area.
  </Card>

  <Card title="Troubleshooting" icon="circle-question" href="/integrations/mcp/troubleshooting">
    Common errors and what to do about them.
  </Card>
</CardGroup>

## Supported AI tools

<CardGroup>
  <Card title="Claude Code" icon="terminal" />

  <Card title="Cursor" icon="code" />

  <Card title="Windsurf" icon="wind" />

  <Card title="Claude Desktop" icon="comment" />

  <Card title="Cline (VS Code)" icon="puzzle-piece" />

  <Card title="Continue.dev" icon="forward" />
</CardGroup>

Any MCP-compatible client works — these are just the ones with auto-detect support in the installer.

## How it works

The MCP server runs locally on your machine via `npx`. It speaks MCP over stdio with your AI tool, and HTTPS to Naridon's API. Your **per-shop API key** authenticates the requests — the server resolves your shop automatically from the key, so you never have to type a shop ID.

```mermaid theme={null}
flowchart LR
    A[Claude Code / Cursor] -- stdio MCP --> B[naridon-mcp]
    B -- HTTPS + X-API-Key --> C[Naridon API]
    C --> D[(Your shop data)]
```

## Security

* Per-shop API keys are scoped — pick the smallest set of permissions a key needs
* Keys can be revoked any time from **Settings → API Keys**
* The server only sends data to Naridon's API; nothing goes to third parties
* The optional CLI installer uses **loopback OAuth** — your raw key is never copied to the dashboard's JavaScript

## Next

<Card title="Quickstart" icon="rocket" href="/integrations/mcp/quickstart">
  One-command install with browser-based authentication.
</Card>


# Manual setup
Source: https://docs.naridon.com/integrations/mcp/manual-setup

Edit your AI tool's MCP config file by hand. Pick this if you don't want to run the installer.

## 1. Generate an API key

1. Sign in to [Naridon](https://app.naridon.com)
2. Go to **Settings → API Keys**
3. Click **Generate API Key**
4. Pick the scopes you need (start with read-only if unsure)
5. Copy the key — it starts with `nrd_`. **You only see it once.**

## 2. Add Naridon to your AI tool's MCP config

<Tabs>
  <Tab title="Claude Code (global)">
    Edit `~/.claude.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "naridon": {
          "command": "npx",
          "args": ["-y", "@naridon/mcp-server"],
          "env": {
            "NARIDON_API_KEY": "nrd_your_api_key_here"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code (project)">
    Create `.mcp.json` in your project root:

    ```json theme={null}
    {
      "mcpServers": {
        "naridon": {
          "command": "npx",
          "args": ["-y", "@naridon/mcp-server"],
          "env": {
            "NARIDON_API_KEY": "nrd_your_api_key_here"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Cursor">
    Edit `~/.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "naridon": {
          "command": "npx",
          "args": ["-y", "@naridon/mcp-server"],
          "env": {
            "NARIDON_API_KEY": "nrd_your_api_key_here"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    Edit `~/.codeium/windsurf/mcp_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "naridon": {
          "command": "npx",
          "args": ["-y", "@naridon/mcp-server"],
          "env": {
            "NARIDON_API_KEY": "nrd_your_api_key_here"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or the equivalent on your OS:

    ```json theme={null}
    {
      "mcpServers": {
        "naridon": {
          "command": "npx",
          "args": ["-y", "@naridon/mcp-server"],
          "env": {
            "NARIDON_API_KEY": "nrd_your_api_key_here"
          }
        }
      }
    }
    ```
  </Tab>
</Tabs>

## 3. Restart your AI tool

The MCP server is started fresh each time the tool launches. After saving your config, fully quit and reopen the tool.

## 4. Verify

Ask the tool:

> *"Call the whoami tool."*

You should get back your shop name, plan, and the scopes the key has.

## Environment variables

| Variable          | Required | Default                          | Description                                                      |
| ----------------- | -------- | -------------------------------- | ---------------------------------------------------------------- |
| `NARIDON_API_KEY` | Yes      | —                                | Per-shop API key. Starts with `nrd_`.                            |
| `NARIDON_API_URL` | No       | `https://app.naridon.com/api/v1` | API base URL. Override for staging.                              |
| `NARIDON_SHOP_ID` | No       | (resolved from key)              | Override the shop the key resolves to. Only for multi-shop keys. |

For **staging**, set:

```json theme={null}
"env": {
  "NARIDON_API_KEY": "nrd_...",
  "NARIDON_API_URL": "https://api-staging.naridon.com/api/v1"
}
```


# Quickstart
Source: https://docs.naridon.com/integrations/mcp/quickstart

Connect Naridon to your AI tool in under 60 seconds. One command, zero JSON editing.

## One command

```bash theme={null}
npx @naridon/mcp-server install
```

That's it. The installer guides you through the rest:

<Steps>
  <Step title="Detects your AI tools">
    The installer scans for Claude Code, Cursor, Windsurf, Claude Desktop, Cline, and Continue. You pick which to configure (or all of them).
  </Step>

  <Step title="Picks scope">
    Choose **global** (use Naridon in every project) or **project** (only this directory's `.mcp.json`).
  </Step>

  <Step title="Signs you in">
    Opens your browser to Naridon. You're already logged in, so one click authorizes the CLI. The dashboard mints a scoped API key and sends it to the installer over a loopback address.
  </Step>

  <Step title="Writes your config">
    The installer adds Naridon to your AI tool's MCP config, preserving any other servers you already have.
  </Step>

  <Step title="Verifies the connection">
    Calls `/whoami` to confirm the key works, prints which shop and plan you're connected to.
  </Step>
</Steps>

After it finishes, restart your AI tool and ask:

> *"What's my Naridon visibility score?"*

<Note>
  If you'd rather not run a script, see [Manual setup](/integrations/mcp/manual-setup) for the JSON config.
</Note>

## What gets created

A new API key on your shop named something like `CLI install 2026-04-10` with these scopes:

* `read:dashboard`
* `read:fixes`
* `read:prompts`
* `read:competitors`
* `write:fixes`
* `write:prompts`
* `trigger:scan`

You can review and revoke it any time from **Settings → API Keys** in the dashboard.

## Re-running the installer

Safe to run as many times as you want. Existing config entries are preserved — only the `naridon` MCP server entry is updated.

```bash theme={null}
# Add Naridon to a different AI tool
npx @naridon/mcp-server install

# Add Naridon to a project (after running globally first)
cd ~/my-project
npx @naridon/mcp-server install
# pick "Project" scope
```

## Troubleshooting

If something looks wrong, the most useful thing you can do is ask your AI tool:

> *"Call the whoami tool and tell me which shop I'm connected to."*

The `whoami` tool reports your shop, organization, plan, and the scopes the key has — almost every "it's not working" issue is diagnosable from that single response.

For more, see the [Troubleshooting](/integrations/mcp/troubleshooting) page.


# Tools reference
Source: https://docs.naridon.com/integrations/mcp/tools-reference

All 45 tools the Naridon MCP server exposes, grouped by area.

The MCP server in v0.4.0 exposes 45 tools. **You almost never need to pass `shopId`** — every shop-scoped tool resolves it automatically from your API key.

## Identity (start here)

| Tool         | Description                                                                                                                              |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `whoami`     | Which shop, organization, plan, and scopes the current API key has. Call this first if you're unsure which store the AI is connected to. |
| `list_shops` | All shops accessible from the current key (one in most cases).                                                                           |

## Monitoring

| Tool                  | Description                                                                      |
| --------------------- | -------------------------------------------------------------------------------- |
| `get_dashboard`       | Visibility trends, sentiment, share of voice, citations, top performing prompts. |
| `get_prompt_rankings` | Position and visibility per tracked prompt across AI engines.                    |
| `get_competitors`     | Competitor analysis — strength, gaps, mentions alongside your brand.             |

## Optimization

| Tool                        | Description                                                                          |
| --------------------------- | ------------------------------------------------------------------------------------ |
| `get_store_stats`           | Optimization counts — fixes applied, pending, scan status.                           |
| `get_fix_suggestions`       | Pending fix suggestions with reasoning.                                              |
| `apply_fix`                 | Apply a fix to your store via the platform adapter.                                  |
| `approve_fix`               | Move a drafted fix from `PROPOSED` to `APPROVED`.                                    |
| `revert_fix`                | Restore original content for an applied fix.                                         |
| `trigger_scan`              | Run a fresh optimization scan over all products.                                     |
| `get_autopilot_status`      | Autopilot mode, recent activity, agent toggles.                                      |
| `update_autopilot_settings` | Update autopilot mode (`WATCH`, `ASSIST`, `AUTOPILOT`), daily limits, agent toggles. |
| `get_model_performance`     | Which LLMs produce the best fixes per task type, cost per fix.                       |

## Prompts

| Tool                  | Description                                                      |
| --------------------- | ---------------------------------------------------------------- |
| `create_prompt`       | Track a new AI search query for visibility monitoring.           |
| `run_prompt_analysis` | Run analysis for a prompt across Google AI, ChatGPT, Perplexity. |

## CMS — pages

| Tool                 | Description                                                        |
| -------------------- | ------------------------------------------------------------------ |
| `cms_list_pages`     | List CMS pages with pagination, sorting, field selection.          |
| `cms_get_page`       | Get a single page including content blocks and SEO.                |
| `cms_create_page`    | Create a page with title, slug, content, and full SEO/OG metadata. |
| `cms_update_page`    | Update any subset of page fields.                                  |
| `cms_publish_page`   | Make a page live.                                                  |
| `cms_unpublish_page` | Revert a page to draft.                                            |
| `cms_delete_page`    | Permanently delete a page.                                         |

## CMS — content types & entries

| Tool                      | Description                                  |
| ------------------------- | -------------------------------------------- |
| `cms_list_content_types`  | List custom content types.                   |
| `cms_create_content_type` | Define a new content type with field schema. |
| `cms_delete_content_type` | Delete a content type and all its entries.   |
| `cms_list_entries`        | List entries for a content type.             |
| `cms_create_entry`        | Create an entry.                             |
| `cms_update_entry`        | Update an entry.                             |
| `cms_delete_entry`        | Delete an entry.                             |

## CMS — media, SEO, export

| Tool             | Description                     |
| ---------------- | ------------------------------- |
| `cms_list_media` | List uploaded media files.      |
| `cms_get_seo`    | SEO metadata for a page.        |
| `cms_export`     | Export all CMS content as JSON. |

## CMS — i18n

| Tool                          | Description                                   |
| ----------------------------- | --------------------------------------------- |
| `cms_list_translations`       | List locale variants of a page.               |
| `cms_create_translation`      | Create a translation of a page.               |
| `cms_list_entry_translations` | List locale variants of a content type entry. |

## CMS — preview & roles

| Tool                   | Description                                                          |
| ---------------------- | -------------------------------------------------------------------- |
| `cms_generate_preview` | Generate a preview token + URL for an unpublished page.              |
| `cms_preview_entry`    | Same for a content type entry.                                       |
| `cms_list_roles`       | List CMS role assignments.                                           |
| `cms_create_role`      | Assign a CMS role (`ADMIN`, `EDITOR`, `AUTHOR`, `VIEWER`) to a user. |
| `cms_update_role`      | Change a role assignment.                                            |
| `cms_delete_role`      | Remove a role assignment.                                            |

## Catalog (Naridon Shop)

| Tool                 | Description                                                              |
| -------------------- | ------------------------------------------------------------------------ |
| `catalog_search`     | Search the global product directory by keyword, category, vendor, price. |
| `catalog_product`    | Full product details — AI summary, specs, FAQ, reviews.                  |
| `catalog_compare`    | Side-by-side comparison of 2-5 products.                                 |
| `catalog_categories` | All categories with product counts.                                      |

## Optional `shopId` parameter

Tools that act on shop data accept an optional `shopId` argument. **You should not pass it** — the server auto-resolves it from your API key. The only reason to pass it is if you have a multi-shop key and want to act on a non-default shop.


# Troubleshooting
Source: https://docs.naridon.com/integrations/mcp/troubleshooting

Common errors from the Naridon MCP server and what to do about them.

The MCP server in v0.4.0 returns LLM-readable error hints — your AI tool can usually self-correct just by reading them. If it can't, here's the manual fallback for each.

## "Authentication failed (401)"

Your API key is missing, expired, or revoked.

**Fix:**

1. Generate a new key in [Settings → API Keys](https://app.naridon.com/settings?tab=apiKeys)
2. Update `NARIDON_API_KEY` in your AI tool's MCP config
3. Restart the AI tool

## "Forbidden (403)"

Your API key is missing the scope this tool needs.

**Fix:**

1. Ask your AI to call the `whoami` tool to see your current scopes
2. Re-create the key in **Settings → API Keys** with the missing scope checked
3. Update the config and restart

The 8 scopes are: `read:dashboard`, `read:fixes`, `read:prompts`, `read:competitors`, `write:fixes`, `write:prompts`, `write:autopilot`, `trigger:scan`.

## "Not found (404)"

The resource ID is wrong, or it belongs to a different shop.

**Fix:** Tell your AI to use a list/search tool first (e.g. `get_fix_suggestions`) to find the correct ID.

## "Rate limited (429)"

You've hit the API key's rate limit (default 300 requests/minute).

**Fix:**

* Wait 60 seconds and retry
* Or raise the limit in **Settings → API Keys** → edit the key

## "Could not reach Naridon API"

Network error — the server can't reach `app.naridon.com`.

**Fix:**

1. Check `NARIDON_API_URL` is correct (default: `https://app.naridon.com/api/v1`)
2. If on a corporate network, ensure HTTPS to `app.naridon.com` is allowed
3. If running locally, make sure the backend is up

## "No Naridon credentials configured"

The MCP server started but neither `NARIDON_API_KEY` nor `NARIDON_API_TOKEN` was set.

**Fix:** Add `NARIDON_API_KEY` to the `env` block in your tool's MCP config. See [Manual setup](/integrations/mcp/manual-setup).

## The AI tool doesn't see Naridon at all

The MCP server isn't being launched. Causes:

* The config file wasn't saved, or has invalid JSON → re-run `npx @naridon/mcp-server install` to rewrite it cleanly
* You didn't restart the AI tool after editing the config
* `npx` isn't on the AI tool's `PATH` → install Node.js 18+

**Fix:** Quit the AI tool fully (not just close window), then reopen.

## CLI installer says "Browser auth timed out"

You took longer than 5 minutes to authorize, or you closed the browser tab.

**Fix:** Re-run `npx @naridon/mcp-server install` and complete the browser flow within 5 minutes.

## CLI installer says "Could not deliver key to your CLI"

The dashboard tried to POST the key back to your loopback server, but the installer wasn't listening anymore.

**Causes:**

* You canceled the installer with Ctrl+C
* A firewall is blocking `127.0.0.1` connections
* The loopback port was already in use

**Fix:** Re-run the installer. The server picks a fresh random port each time.

## "Verification failed" after manual setup

The key you pasted doesn't authenticate against the API.

**Fix:**

1. Generate a fresh key — copy the **whole** value (it's long)
2. Make sure there are no leading/trailing spaces
3. Confirm `NARIDON_API_URL` matches the environment the key was created in (production vs staging)

## Still stuck

The fastest path to a fix: ask your AI tool

> *"Call the whoami tool, then call get\_dashboard, and tell me exactly what each one returned."*

Send the output to **[support@naridon.com](mailto:support@naridon.com)**.


# Installation
Source: https://docs.naridon.com/quickstart

Get started with Naridon on your Shopify store in minutes

## 3-Step Onboarding

Naridon features a streamlined onboarding process designed to get you results in under 2 minutes.

<Steps>
  <Step title="Silent Scan">
    Immediately after installation, Naridon runs a background "Silent Scan."
    It analyzes your metadata and calculates a **Visibility Snapshot** before you even configure a setting.
  </Step>

  <Step title="Prompt Selection">
    Tell us what you want to rank for.

    * **Choose**: Select from high-value customer questions we identified during the scan.
    * **Custom**: Write your own target questions (e.g., *"Best vegan leather boots under \$200"*).
  </Step>

  <Step title="Automation Mode">
    Select your comfort level:

    * **Suggest Only**: You review every change.
    * **Assist Mode**: We handle the small stuff; you handle the big stuff.
    * **Full Autopilot**: We optimize your store aggressively for maximum growth.
  </Step>
</Steps>

## Next Steps

Once onboarded, head to the **Monitor** tab to see your initial rankings, or the **Improve** tab to start fixing product gaps.


# Trust & Safety
Source: https://docs.naridon.com/trust-safety

How Naridon secures your data and ensures safe AI interactions

## AI Guardrails

Naridon implements strict guardrails to ensure that AI interactions are safe, accurate, and on-brand.

### 1. Hallucination Prevention

We use advanced AI architecture that grounds all AI responses in your actual store data.

* **Fact-Checking**: The AI is explicitly instructed to only answer questions based on the provided product catalog and knowledge base.
* **"I Don't Know" Fallback**: If the AI cannot find an answer in your data, it is trained to admit it politely rather than inventing information.

### 2. PII Redaction

To protect your customers' privacy, Naridon automatically detects and redacts Personally Identifiable Information (PII) before sending data to any LLM.

* **Redacted Fields**: Email addresses, phone numbers, and credit card patterns are masked in logs and processing pipelines.
* **Compliance**: This ensures compliance with GDPR and Shopify's data protection requirements.

### 3. Brand Safety & Tone

You have control over how the AI speaks to your customers.

* **Profanity Filters**: Strict filters prevent the AI from generating or engaging with offensive language.
* **Competitor Blocking**: The AI is trained not to discuss or recommend competitor brands, even if asked directly.
* **Tone Enforcement**: Whether you choose "Professional" or "Friendly," the AI adheres to system prompts that enforce your specific brand voice.

## Data Privacy

We take data stewardship seriously. We only process the data necessary to provide our services.

### What We Access

* **Product Data**: Titles, descriptions, prices, and inventory levels (to provide accurate answers).
* **Store Policy**: Shipping, return, and privacy policies you upload to the Knowledge Base.
* **Interaction Logs**: Anonymous chat logs to help you analyze customer intent.

### What We Do NOT Store

* **Customer Payment Info**: We never access or store credit card details.
* **Passwords**: We do not have access to customer account passwords.

## Security Infrastructure

Naridon is built on enterprise-grade infrastructure.

* **Encryption**: All data is encrypted in transit (TLS 1.2+) and at rest (AES-256).
* **Shopify Native**: We are an embedded Shopify App, meaning we leverage Shopify's secure authentication (OAuth) for admin access. We do not manage separate usernames/passwords for your staff.
* **LLM Security**: We use enterprise-grade AI service providers which do not train their models on your API data (Zero Data Retention policies where applicable).

## Compliance

### GDPR & CCPA

Naridon is designed to be GDPR and CCPA compliant.

* **Right to Erasure**: When a customer requests data deletion via Shopify, we automatically purge associated chat logs and data.
* **Data Processing Agreement**: Our terms include standard DPA clauses protecting your rights as a data controller.

For more details, please contact our Data Protection Officer at [privacy@naridon.com](mailto:privacy@naridon.com).