old-website-finder 1.2.0

Hermes-style CLI agent that finds outdated Uzbekistan websites and runs deep upgrade analysis (Grok/GPT/Claude/Gemini)

Old Website Finder Agent (owf)

Hermes-uslubidagi professional CLI agent — O‘zbekiston ichidagi eskirgan veb-saytlarni topadi, deep analysis qiladi, multi-provider LLM orqali tashxis qo‘yadi.

Install (public)

# PyPI (nom publish qilingandan keyin)
pip install old-website-finder

# yoki pipx (tavsiya — global CLI)
pipx install old-website-finder

# yoki to‘g‘ridan-to‘g‘ri GitHubdan
pip install git+https://github.com/FarrukhDevloper/owf/OldWebsiteFinder.git

owf --version

# TO‘G‘RI TARTIB:
owf login              # 1) hisob ulash (API key) — AVVAL
owf model              # 2) model tanlash — ixtiyoriy
owf daily              # 3) agent

# yoki
owf login claude
owf login grok --api-key xai-...
owf setup              # wizard ham avval login so‘raydi

Batafsil: PUBLISH.md · Auth tushuntirish: owf login --help

owf                 # banner + status
owf setup           # interaktiv sozlash
owf auth add grok   # API key yoki OAuth
owf daily           # kunlik skan + analysis

Imkoniyatlar

Modul	Buyruqlar
Setup	owf setup, owf doctor, owf status
Auth pool	owf auth add/list/remove/status/logout
Model	owf model, owf providers, owf config
Agent	owf daily, owf analyze, owf schedule
Tarix	owf history, owf show, owf runs

Multi-provider LLM

Provider	ID	Auth
xAI / Grok	grok	API key + OAuth token
OpenAI / GPT	openai	API key + OAuth token
Anthropic / Claude	claude	API key + OAuth token
Google / Gemini	gemini	API key + OAuth token
Custom OpenAI-compat	custom	API key + base URL

Credentiallar: ~/.owf/auth.json (Hermes-style pool)
Config: ~/.owf/config.yaml

OAuth haqida: CLI brauzerni ochadi va access token / API key ni xavfsiz saqlaydi.
ChatGPT Pro yoki Claude.ai consumer session OAuth rasmiy third-party client talab qiladi — shuning uchun bu yerda API key + Bearer OAuth token modeli ishlatiladi (Hermes auth add UX).

O‘rnatish

cd "C:\New projects\Agents\OldWebsiteFinder"
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
pip install -e .

Tezkor start (Hermes kabi)

owf setup
# yoki
owf auth add grok
owf auth add openai --api-key sk-...
owf auth add claude --type oauth
owf auth add gemini

owf model
owf status
owf doctor

owf daily -n 3
owf analyze https://example.uz --provider claude

Auth misollar

# Interaktiv (brauzer ochiladi)
owf auth add grok
owf auth add openai
owf auth add claude
owf auth add gemini

# Non-interactive
owf auth add grok --api-key xai-...
owf auth add openai --api-key sk-...
owf auth add claude --api-key sk-ant-...
owf auth add gemini --api-key AIza...
owf auth add claude --access-token eyJ... --type oauth

owf auth list
owf auth remove grok 1
owf auth logout openai

Model / config

owf model -p grok -m grok-4.5
owf model -p claude -m claude-sonnet-4-20250514
owf config show
owf config set agent.daily_analysis_limit 10
owf config set fallback.providers "openai,claude"

Env orqali ham ishlaydi (pool bo‘sh bo‘lsa):

XAI_API_KEY=
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GEMINI_API_KEY=

Agent pipeline

1. Discovery — .uz seed + data/seed_sites.txt
2. Tech scan — HTTPS, eski PHP/jQuery, table layout, CMS, security headers
3. Priority score — upgrade ehtiyoj × auditoriya proxy
4. Deep analysis — tanlangan LLM (Grok/GPT/Claude/Gemini)
5. Persist — SQLite + reports/YYYY-MM-DD/*.md|json

CLI reference

owf                         banner + status dashboard
owf setup                   setup wizard
owf doctor                  health check
owf status                  component status
owf providers               LLM provider ro‘yxati
owf auth add <provider>     credential qo‘shish
owf auth list               pool
owf auth remove <p> <ref>   o‘chirish
owf auth logout [provider]  tozalash
owf model                   provider/model picker
owf config show|set|edit|path
owf daily [-n N] [-p provider] [-m model]
owf analyze URL
owf history [--date YYYY-MM-DD]
owf show <analysis_id>
owf runs
owf schedule --hour 9

Fayl tuzilmasi

~/.owf/
  auth.json          # credential pool
  config.yaml        # model, limits, fallback
  .env               # optional secrets
  reports/           # optional home reports
  logs/

src/old_website_finder/
  cli.py             # Hermes-style commands
  ui.py              # banner / panels
  home.py            # ~/.owf
  auth/              # providers, store, login
  llm/               # multi-provider router
  discovery/         # scan + score
  analysis/          # deep analysis
  pipeline/          # daily orchestrator

Eslatma

• Agent read-only — saytlarni o‘zgartirmaydi.
• Auditoriya bahosi proxy (analytics emas).
• Productionda data/seed_sites.txt ni kengaytiring.