Gene Library Courses Download Pricing Contact Sign in
Gene Library
GENE-FELUDAWP Documentation

Getting Started with Gene-FeludaWP — API Keys and Configuration Guide

Overview

Gene-FeludaWP connects to three external services. This guide explains exactly where to get each credential and how to configure them in the Feluda Vault. Setup takes about 15 minutes.

1. WordPress Credentials (Required)

Your WordPress site needs an Application Password so the Gene can authenticate securely without using your main account password.

Getting Your WordPress Application Password

  1. Log into your WordPress admin panel (usually at yoursite.com/wp-admin)
  2. Go to Users → Profile
  3. Scroll down to Application Passwords
  4. Enter a name like "Feluda Gene" and click Add New Application Password
  5. WordPress will show a password — copy it immediately. It looks like: abcd 1234 efgh 5678 ijkl mnop
  6. Save this password somewhere safe. WordPress only shows it once.

Getting Your Author ID

  1. Go to Users → All Users in the WordPress sidebar
  2. Click on your username
  3. Look at the browser URL: yoursite.com/wp-admin/user-edit.php?user_id=3
  4. The number after user_id= is your author ID (in this example, 3)

Configuring WordPress Secrets in Feluda Vault

Open the Feluda Vault for this Gene and add these four secrets:

Secret Name Value Example
WORDPRESS_USERNAME Your WordPress login username editor
WORDPRESS_TOKEN The application password you copied abcd 1234 efgh 5678 ijkl mnop
WORDPRESS_SITE_URL Your full site URL with https:// https://huurhacker.nl
WORDPRESS_AUTHOR_ID Your numeric WordPress user ID 3

The application password includes spaces. Copy it exactly as shown.

2. NewsAPI.org Key (Optional — for worldwide news search)

NewsAPI.org lets the AI search articles from over 80,000 news sources worldwide.

Getting Your Key

  1. Go to https://newsapi.org/register
  2. Fill in your name, email, and a password
  3. After registration, you'll see your API key on the dashboard
  4. The key looks like: 197b91d960e74c7bb34bec5af15db6f3

Free Tier Limits

  • 100 requests per day
  • Articles delayed up to 24 hours
  • Max 100 results per request
  • Cannot search articles older than 1 month

Configuring in Feluda Vault

Secret Name Value
NEWSAPI_KEY Your NewsAPI.org API key

3. NewsData.io Key (Optional — for latest and breaking news)

NewsData.io provides latest news with powerful filtering by country, category, language, and domain.

Getting Your Key

  1. Go to https://newsdata.io/
  2. Click Get API Key or Sign Up
  3. Create an account with your email
  4. Your API key will be displayed on the dashboard
  5. The key looks like: pub_2645eeeeac84471685544e55995d8365

Free Tier Limits

  • 500 requests per day
  • Articles delayed by 12 hours
  • Max 10 results per request

Configuring in Feluda Vault

Secret Name Value
NEWSDATA_KEY Your NewsData.io API key

4. Gene Settings (Optional)

These settings are pre-configured with sensible defaults but can be adjusted:

Setting Default Description
wordpress_excerpt_max_length 300 Maximum characters for post excerpts
wordpress_image_width 1200 Default featured image width
wordpress_image_height 630 Default featured image height
Webget.UserAgent Chrome 147 Browser identity for web scraping
Webget.MaxCharsPerView 4000 Characters returned per page view

Access these in the Settings panel of the Gene. You likely won't need to change any of them to get started.

5. Verify Your Setup

After configuring the Vault, ask the AI to perform a simple test:

  • "List my recent WordPress posts" — verifies WordPress credentials
  • "Search news about cybersecurity" — verifies your news API keys
  • "Write and publish a short test post" — verifies the complete workflow

If anything fails, the AI will tell you exactly which credential is missing or incorrect.

Troubleshooting

Problem Likely Cause
"WordPress auth secret missing" WORDPRESS_USERNAME or WORDPRESS_TOKEN is empty or incorrect
"WORDPRESS_AUTHOR_ID not configured" Missing or non-numeric author ID
"NewsAPI request failed HTTP 401" NEWSAPI_KEY is invalid or not yet activated
"NewsData request failed HTTP 401" NEWSDATA_KEY is invalid
"Application password not working" The password was copied incorrectly (include spaces) or was only shown once and lost — generate a new one

Frequently Asked Questions

Do I need all three API services configured?
No. Only WordPress credentials are mandatory. The newsApi tool requires a NewsAPI.org key, the newsdata tool requires a NewsData.io key, and the Webget tool works without any API keys. You can start with just WordPress and add news services later.
Are there free tiers for the news APIs?
Yes. NewsAPI.org offers a free developer tier with 100 requests per day and articles delayed up to 24 hours. NewsData.io offers a free tier with 500 requests per day and articles delayed by 12 hours. Both are sufficient for testing and low-volume publishing.
How do I find my WordPress author ID?
Go to your WordPress admin panel, click "Users" in the sidebar, and click on your username. Look at the URL in your browser — it will end with something like `user_id=3`. The number is your author ID. Alternatively, hover over your username and the ID appears in the status bar.
Can I use this with WordPress.com hosted sites?
Only if your WordPress.com plan supports Application Passwords and REST API access. This is available on Business and Commerce plans. Free and Personal plans on WordPress.com have restricted API access and may not work.
What if a news article I want to use is behind a paywall?
The Webget tool can only fetch publicly accessible pages. If a news source blocks automated access or requires a subscription, Webget will not be able to retrieve the full article. Use the article summaries provided by the news APIs instead, which include descriptions and metadata.