Israeli Tech Nano-Influencers Database

A SQLite database with direct sqlite3 command-line access for managing Israeli tech nano-influencer data. Pure SQL with no abstractions.

Features

• Direct sqlite3 Access: Execute any SQL query using the sqlite3 CLI
• Schema Inspection: View database schema and table structures
• Flexible: Craft any query you need with full SQL power
• Version Controlled: Database file is tracked in git for easy collaboration

Database Schema

Tables

influencers

- Single table for all influencers (active and excluded)

Profile & Identity:

• twitter_handle

  (TEXT PRIMARY KEY) - Twitter/X username

• name

  (TEXT NOT NULL) - Full name

• role

  (TEXT) - Professional role/title

• focus

  (TEXT) - Areas of expertise or interest

• background

  (TEXT) - Professional background

• profile_url

  (TEXT) - Link to Twitter/X profile

Engagement & Activity:

• recent_activity

  (TEXT) - Description of recent posts/activity

• engagement_potential

  (TEXT) - Assessment of engagement value (HIGH/MEDIUM/LOW)

• last_tweet_date

  (TEXT) - Date of most recent tweet

• last_reply_date

  (TEXT) - Date of most recent reply

Location & Language:

• location

  (TEXT) - Geographic location

• language

  (TEXT) - Languages used in content

• hebrew_writer

  (BOOLEAN) - Whether they write in Hebrew (0/1)

X API Metrics (matching UserInfoResponse model):

• followers

  (INTEGER) - Number of followers

• following

  (INTEGER) - Number of accounts they follow

• statuses_count

  (INTEGER) - Total number of tweets/statuses

• media_count

  (INTEGER) - Total media items posted

Discovery & Tracking:

• discovery_path

  (TEXT) - How the influencer was discovered/found (e.g., web search query, xai-grok search, website URL, referral path, Twitter list, recommendation from another influencer, etc.)

• rationale

  (TEXT) - Why this influencer was added to the database (e.g., specific expertise, notable projects, unique perspective, community influence, content quality, etc.)

• added_date

  (TEXT NOT NULL) - Date added to database (ISO 8601 format)

• last_verified_date

  (TEXT) - Date profile was last verified (ISO 8601 format)

Exclusion Management:

• excluded

  (BOOLEAN DEFAULT 0) - Whether excluded from active list (0=active, 1=excluded)

• excluded_date

  (TEXT) - Date of exclusion (ISO 8601 format, nullable)

• exclusion_reason

  (TEXT) - Reason for exclusion (nullable)

Metadata:

• notes

  (TEXT) - Additional notes or observations

• created_at

  (TIMESTAMP DEFAULT CURRENT_TIMESTAMP) - Record creation timestamp

• updated_at

  (TIMESTAMP DEFAULT CURRENT_TIMESTAMP) - Last update timestamp (auto-updated)

Indexes:

• idx_influencers_location

  - Fast queries by location

• idx_influencers_hebrew_writer

  - Fast queries by language

• idx_influencers_followers

  - Fast queries by follower count

• idx_influencers_excluded

  - Fast queries for active vs excluded

Using sqlite3

The database is accessed using the

sqlite3

command-line tool (pre-installed on most systems).

Basic Usage

# Open database in interactive mode
sqlite3 influencers.db

# Execute a single query
sqlite3 influencers.db "SELECT * FROM influencers LIMIT 5"

# Get JSON output
sqlite3 influencers.db ".mode json" "SELECT * FROM influencers LIMIT 5"

Common sqlite3 Commands

Meta commands (start with

.

):

.tables                    # List all tables
.schema influencers        # Show table schema
.mode json                 # Set output to JSON format
.mode column               # Set output to column format
.headers on                # Show column headers
.quit                      # Exit sqlite3

SQL Query Examples

SELECT Queries

# Get all influencers
sqlite3 influencers.db "SELECT * FROM influencers"

# Get specific influencer
sqlite3 influencers.db "SELECT * FROM influencers WHERE twitter_handle = 'oriSomething'"

# Get with JSON output
sqlite3 influencers.db -json "SELECT * FROM influencers WHERE location LIKE '%Tel Aviv%'"

# Count by location
sqlite3 influencers.db "SELECT location, COUNT(*) as count FROM influencers GROUP BY location"

INSERT Queries

# Add new influencer
sqlite3 influencers.db "INSERT INTO influencers (twitter_handle, name, location, followers, hebrew_writer, added_date, last_verified_date) VALUES ('test_user', 'Test User', 'Tel Aviv', 1500, 1, '2025-10-26', '2025-10-26')"

# Add with more fields
sqlite3 influencers.db "INSERT INTO influencers (twitter_handle, name, role, focus, location, language, followers, following, statuses_count, media_count, hebrew_writer, engagement_potential, discovery_path, added_date) VALUES ('example', 'Example User', 'Developer', 'AI/ML', 'Israel', 'Hebrew, English', 2000, 500, 1500, 300, 1, 'HIGH', 'web search: Israeli AI developers', '2025-10-26')"

UPDATE Queries

# Update follower count
sqlite3 influencers.db "UPDATE influencers SET followers = 2000 WHERE twitter_handle = 'test_user'"

# Update multiple X API metrics
sqlite3 influencers.db "UPDATE influencers SET followers = 2500, following = 600, statuses_count = 2000, media_count = 400 WHERE twitter_handle = 'test_user'"

DELETE Queries

# Delete specific influencer
sqlite3 influencers.db "DELETE FROM influencers WHERE twitter_handle = 'test_user'"

Architecture

.claude/skills/influencer-db/
├── SKILL.md              # This documentation
└── src/
    └── schema.sql       # Database schema (for reference)
influencers.db           # SQLite database (version controlled in git)

Tips for Agents

• Use JSON output: Add

  -json

  flag for JSON output:

  sqlite3 influencers.db -json "SELECT ..."

• Use transactions: For multiple operations, wrap in transaction (BEGIN/COMMIT)
• Check constraints: twitter_handle is PRIMARY KEY - handle conflicts gracefully
• Use indexes: location, followers, hebrew_writer, and excluded are indexed for fast queries
• Track discovery: Always populate

  discovery_path

  (how found) and

  rationale

  (why added) when adding new influencers to track sourcing and decision-making