Documentation

Setup Steps

1. Visit Perplexity API and create an account
2. Navigate to API settings and generate your API key
3. In plugin settings, choose "Perplexity (Agentic Search)"
4. Paste your key in the "Perplexity API key" field

Model: Uses sonar with built-in web search capabilities

Setup Steps

1. Visit OpenAI API
2. Create or copy your API key
3. In plugin settings, choose "OpenAI GPT (Agentic Search)"
4. Paste your key in the "OpenAI API key" field

Model: Uses gpt-5-search-api with integrated web search

Setup Steps

1. Visit xAI Grok API
2. Generate your API key
3. In plugin settings, choose "Grok (Agentic Search)"
4. Paste your key in the "Grok API key" field

Model: Uses grok-4-fast with real-time X platform data

Setup Steps (3 Free API Keys Required)

1. Google Custom Search API Key (FREE):

• Go to Google Cloud Console
• Create a new project or select existing
• Enable "Custom Search API"
• Go to Credentials → Create Credentials → API Key
• Copy the generated API key

2. Google Search Engine ID (FREE):

• Visit Programmable Search Engine
• Click "Add" to create new search engine
• Under "Sites to search", select "Search the entire web"
• Create the search engine
• Copy the Search Engine ID from the overview page

3. Gemini API Key (FREE):

• Go to Google AI Studio
• Click "Get API Key"
• Create or select a project
• Copy the generated key

4. Configure in Plugin:

• Choose "Google Search + Gemini Summarizer" as your News Pipeline
• Enter all three keys in their respective fields

Models: Google Custom Search API + gemini-2.5-flash

Setup Steps

Requires the same Google keys as Option D, plus:

• OpenAI API Key: Get from OpenAI API

In plugin settings, choose "Google Search + GPT Summarizer" and enter all three keys.

Setup Steps

Requires the same Google keys as Option D, plus:

• Grok API Key: Get from xAI

In plugin settings, choose "Google Search + Grok Summarizer" and enter all three keys.

Example 1: Focus on Breaking News

Analyze the following news and extract only breaking news and major announcements.
Ignore opinion pieces, analysis articles, and minor updates.

News content:
{{NEWS_TEXT}}

Format as bullet points with:
- Bold headline
- 2-3 sentence summary
- Source link with date

Example 2: Technical Focus

From the following news, extract technical details and specifications.
Focus on: product releases, technical breakthroughs, and research findings.

{{NEWS_TEXT}}

For each item include:
- Technical specifications
- Key innovations
- Potential impact on industry

Example 3: Investment Focus

Analyze this news from an investor's perspective:

{{NEWS_TEXT}}

For each news item, provide:
- Market impact assessment
- Key financial metrics mentioned
- Investment implications
- Risk factors

Example 1: Quality Filter

Select the 5 most significant and credible news items about {{TOPIC}} from the list below.

Prioritize:
- Breaking news from reputable sources
- Major company announcements
- Research papers and studies
- Expert analysis

Exclude:
- Opinion pieces and editorials
- Social media posts
- Advertisements and sponsored content
- Duplicate or similar stories

News list:
{{NEWS_TEXT}}

Example 2: Diverse Perspective

From the following news about {{TOPIC}}, select 5 items that provide diverse perspectives.

Ensure variety in:
- Geographic regions (US, EU, Asia, etc.)
- Source types (mainstream, tech blogs, financial, research)
- Viewpoints (bullish, bearish, neutral)

{{NEWS_TEXT}}

Return items that together give a balanced, comprehensive view.

Possible Causes & Solutions

1. API Key Issues:
   • Check that API keys are correctly entered (no extra spaces)
   • Verify keys are active and haven't expired
   • For Google providers, ensure all 3 keys are entered
2. Topics Not Configured:
   • Ensure topics are comma-separated
   • Topics should be specific (not too broad)
3. Network Issues:
   • Verify your internet connection
   • Check if API endpoints are accessible
4. Debug:
   • Try manual generation first to see detailed errors
   • Open Obsidian console (Ctrl/Cmd + Shift + I)
   • Look for error messages in the console

Solutions

• Missing {{TOPICS}}: Ensure your custom template includes {{TOPICS}} placeholder
• Typos in placeholders: Check for typos (placeholders are case-sensitive)
• Unknown placeholders: Remove any placeholders not listed in documentation
• Empty template: Template cannot be completely empty
• Test: Switch to a preset template to verify the issue

For Google-Based Providers:

• ✅ Enable "Use AI for Search Queries" for better search optimization
• ✅ Enable "Use AI News Judgment" for better content selection
• Adjust "Results per Topic" (try 7-10 for better coverage)
• Shorten date range (use d1 for most recent news)
• Use more specific topics (e.g., "NVIDIA stock news" instead of "technology")

For All Providers:

• Be more specific with topics
• Try different AI providers to compare quality
• Use custom prompts to guide the AI's focus
• Adjust output format (detailed vs concise)