Keywordpro

Abstract

1. Introduction

Keyword Pro is a standalone, local keyword research console. It combines a guided keyword report with an advanced endpoint explorer, saved research sessions, charts, and exports.

There is no signup, billing layer, or hosted account system. One local user owns the database and supplies their own DataForSEO credentials.

The screenshots below were captured from the actual local application using a deterministic synthetic report. They contain no account data, credentials, or captured provider results. Live results vary by query, market, language, and available provider data.

2. Objective

Local-first keyword research with guided reports, charts, saved sessions, and PDF, CSV, and JSON exports.

This project demonstrates how TypeScript, Next.js can be applied to a real-world Digital Marketing & SEO problem.

3. Key Features / Modules

• Runs a guided, market-aware report with up to 19 calls covering volume, CPC,
• Offers 94 markets and all 46 languages supported by the guided keyword
• Exposes 332 keyword-oriented DataForSEO endpoint definitions in
• Saves completed reports locally so reopening a report makes no paid API call.
• Exports keyword results as PDF, CSV, and JSON.
• Displays the estimated cost before a paid run begins.

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/AgriciDaniel/keywordpro.git
cd keywordpro

cp .env.example .env
openssl rand -base64 32
pnpm install --frozen-lockfile --ignore-workspace

./dev-up.sh

pnpm --ignore-workspace db:migrate
pnpm --ignore-workspace seed

pnpm --ignore-workspace legacy:inventory

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Export reports to Google Sheets or PDF
• Schedule weekly automated reports
• Add competitor comparison

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Which marketing or SEO problem does this tool solve?
2. Which data sources or APIs does it use (Search Console, Analytics, social platforms)?
3. Which metrics or KPIs does it report and how are they calculated?
4. How could the output help a business make decisions?
5. How would you schedule it to run automatically?

9. Source Code & License

This project is developed by AgriciDaniel and published on GitHub under the Apache License 2.0. Please follow the license terms and credit the original author when you use or modify this code.