AI

SuperDir uses AI models to analyze the content of the website and automatically fill in the submission form, which improves the efficiency of the submission process.

SuperDir uses Vercel AI SDK to wrap AI models and supports OpenAI ChatGPT, Google Gemini, DeepSeek, XAI and Claude models by default, which can be selected according to the needs of the directory.

Administrators can use AI bulk import feature to 10X faster initialize your directory database.

Set the environment variables

Determine the AI model to use

You can choose to use google, deepseek, openai, xai or claude as the AI model, and set the NEXT_PUBLIC_DEFAULT_AI_PROVIDER variable in the .env file.

.env

# ai provider: `google`, `deepseek`, `openai`, `xai`, `claude`
NEXT_PUBLIC_DEFAULT_AI_PROVIDER=

Set the API Key and Model name of the corresponding AI model

.env

AI_MODEL_NAME=
AI_API_KEY=

NEXT_PUBLIC_DEFAULT_AI_PROVIDER is not configured with any AI model, so the AI autofill feature is not enabled by default.
Different models have different effects, we recommend using the Google Gemini model gemini-2.5-flash, which has a larger context window, better effect, and is free.
Please note that the success rate of the AI autofill feature is not 100%, if the webpage content is not captured or the SEO information is not accurate, it may lead to the AI model unable to correctly parse the webpage content, and finally lead to the AI autofill feature failure.

After configuration of AI models, the AI Autofill button will appear in the submission form if the AI environment variables are configured, and click the button will trigger the AI model to automatically parse the webpage content and fill in the form.

Customizing the AI agent rules

To those that use Cursor or GitHub Copilot - You can customize the AI agent rules by updating the respected file listed below. For context, each chat response will read through the file and repspond with a more currated response based on your rules. It is important to

Keep your instructions short and precise. Poor instructions can degrade Cursor and Copilots quality and performance.

Cursor

Update the .cursorrules file to customize the AI agent to your project needs. These rules can be updated at any time and will better help you over time.

Great examples of how to customize your Cursor Rules can be found at awesome-cursorrules.

Learn more about Cursor Rules.

GitHub Copilot

In order to begin using GitHub Copilot Instructions, you must first enable the Use Instruction Files setting in VSCode.

Update the .github/copilot-instructions.md file to customize the AI agent to your project needs. These instructions can be updated at any time and will better help you over time.

It is important to note that AI outputs may still include hallucinations or inaccuracies, so always review and validate the generated suggestions.