# BidBes Services Hub

> A unified microservices portal for AI, content, commerce, gaming, music and creative tools — all behind a single SSO identity.

BidBes is a suite of independent web services unified under one portal at https://bidbes.com. Each service is a self-contained micro-app with its own backend and frontend, connected via shared SSO authentication (JWT). Every service below is free to use and is individually described in its own `llms.txt` file.

## Services

- **Auction** (`/auction/`) — Online auction & classified ads marketplace: real-time bidding, image/video processing, Telegram bot integration, messaging, wallet, and SEO sitemaps. [llms.txt](/auction/llms.txt)
- **Relax** (`/relax/`) — Ambient sounds & focus relaxation PWA: layered soundscapes, offline support, user accounts, and community features. [llms.txt](/relax/llms.txt)
- **Content Engine** (`/content-engine/`) — AI-powered website content intelligence: crawls sites, detects SEO/GEO/AEO opportunities, generates articles, and auto-publishes them. [llms.txt](/content-engine/llms.txt)
- **AI Chatbot** (`/ai-chatbot/`) — Central multi-model AI assistant (Google Gemini, OpenCode, Kilo): chat, image generation, voice mode, web-search grounding, and the AI backbone other services delegate to. [llms.txt](/ai-chatbot/llms.txt)
- **ISI Article Maker** (`/isi/`) — AI academic writing assistant for ISI/WoS journal articles: structured abstracts, section drafting, LaTeX, BibTeX, and manuscript audit. [llms.txt](/isi/llms.txt)
- **QR Code Generator** (`/qrcode/`) — Client-side QR code creator: URLs, WiFi, vCards, SMS, email, crypto, events — with colors, logos, and scan/decode. [llms.txt](/qrcode/llms.txt)
- **PDF Tools** (`/pdftools/`) — Client-side PDF toolkit: merge, split, reorder, compress, watermark, image-to-PDF. No server processing. [llms.txt](/pdftools/llms.txt)
- **NEXUS Gamer Social** (`/nexus/`) — Gaming social network: real-time squad chat, tournaments, LFG squad finder, plus AI agents that publish daily Roblox game spotlights and YouTube gaming shorts. [llms.txt](/nexus/llms.txt)
- **TrendPulse Live** (`/trend/`) — Real-time Google Trends radar for 100+ countries with AI explanations of every trending topic. [llms.txt](/trend/llms.txt)
- **SPORTLY** (`/sportly/`) — Sports scores, schedules, news and analysis for NFL, NBA, MLB and NHL, with team pages and AI game previews. [llms.txt](/sportly/llms.txt)
- **TuneAtlas (playlist)** (`/playlist/`) — Free global music streaming powered by SoundCloud: full-length tracks, per-country charts, genre packs, playlist import, live radio. [llms.txt](/playlist/llms.txt)
- **Downloder** (`/downloder/`) — Video & music downloader for YouTube, Instagram, TikTok, X, Facebook, SoundCloud, Spotify and Aparat. [llms.txt](/downloder/llms.txt)
- **Signal** (`/signal/`) — Real-time financial market intelligence: live BUY/SELL/HOLD signals with entry/stop-loss/take-profit trade plans and walk-forward backtest evidence for gold, silver, USD, EUR, AED, GBP, Bitcoin and Tether across 14 markets, including Iran's live TGJU gold & currency network. [llms.txt](/signal/llms.txt) · [full docs](/signal/llms-full.txt)

## Architecture

- **SSO**: Central `portal_users` table with shared JWT_SECRET across all services
- **Proxy**: Portal (nginx + Node gateway) reverse-proxies each service under its path prefix on bidbes.com
- **AI Backend**: ai-chatbot serves as the AI backbone — ISI Article Maker and Content Engine delegate generation to it via HTTP
- **Autonomous Agents**: NEXUS runs server-side AI agents (Roblox chart scout + YouTube shorts curator); Content Engine runs auto-publishing agents synced with Relax; TrendPulse and SPORTLY run live crawl agents with per-country/news sitemaps
- **Deployment**: Docker containers orchestrated via docker-compose on Runflare

## Public API Reference

### Portal Auth
- `POST /portal-api/auth/login` — Authenticate user, returns JWT
- `POST /portal-api/auth/register` — Register new user

### AI Chatbot
- `POST /api/ai/chat` — Main chat endpoint (used by other services)
- `GET /api/health` — Health check

### Content Engine
- `GET /api/health` — Health check
- `GET /content-engine/api/publications/recent?limit=N` — Recently published articles

### ISI Article Maker
- `GET /api/health` — Health check
- `POST /api/gemini/generate-title-abstract` — Generate titles, abstract, keywords
- `POST /api/gemini/draft-section` — Draft a manuscript section
- `POST /api/gemini/polish-academic` — Polish academic writing
- `POST /api/gemini/generate-latex-table-eq` — Generate LaTeX tables/equations
- `POST /api/gemini/generate-bibtex` — Generate BibTeX references
- `POST /api/gemini/audit-manuscript` — Full manuscript audit

### Auction
- `POST /api/auth/*` — Authentication
- `POST /api/auctionBids/*` — Bidding system
- `POST /api/orders/*` — Order management
- Sitemaps: `/auction/sitemap.xml`, `/auction/sitemap-*.xml`

### Relax
- Express REST API (community features, auth, avatars)
- Static Astro frontend with PWA support
- Sitemap: `/relax/sitemap.xml` (index: static + posts chunks)

### NEXUS
- `GET /api/posts` — Feed posts; post pages server-rendered with OG meta
- Sitemap: `/nexus/sitemap.xml` (posts with image tags)

### TrendPulse
- `GET /api/live` and `GET /api/live/{GEO}` — Live trends per country
- `POST /api/explain` — AI explanation for a trending topic
- Sitemap: `/trend/sitemap.xml` (per-country child sitemaps)

### SPORTLY
- `GET /api/news?sport={nfl|nba|mlb|nhl}` — Latest news articles
- `GET /api/teams?q={query}` — Global team directory search
- Sitemaps: `/sportly/sitemap.xml` (pages, news, teams, games, head-to-head)

### TuneAtlas
- `GET /api/music/search?q={query}` — Music search (also accepts SoundCloud URLs)
- `GET /api/music/trending/{countryCode}` — Trending by country
- `GET /api/audio/{sc_id}` — Track stream

### Downloder
- `POST /api/download` — Start a download job (body: { url })
- `GET /api/jobs/{id}` — Job status and files

### Signal
- `GET /api/signal?country=<id>&asset=<id>&lang=<lang>` — Full market intelligence: live quote, 10 timeframe signals with entry/SL/TP trade plans, localized units, OHLC history, news, indicators
- `GET /api/backtest?asset=<id>&tf=<1h|2h|4h|6h|12h>` — Walk-forward evidence: win rate, expectancy in R, W/L counts
- `GET /api/countries` — Supported country list
- `GET /api/assets` — Supported asset list
- `GET /api/news?country=<id>` — Fundamental news feed
- Sitemap: `/signal/sitemap.xml` (every country × asset page, hourly)

## Sitemaps

A single domain-level sitemap index is the mother sitemap for the whole ecosystem; it points to each service's own sitemap (one crawl tree under bidbes.com):

- Mother index: https://bidbes.com/sitemap.xml
- Child sitemaps it references:
  - Auction: https://bidbes.com/auction/sitemap.xml
  - Content Engine: https://bidbes.com/content-engine/content_sitemap/sitemap-index.xml
  - NEXUS: https://bidbes.com/nexus/sitemap.xml
  - Relax: https://bidbes.com/relax/sitemap.xml
  - Signal: https://bidbes.com/signal/sitemap.xml
  - SPORTLY: https://bidbes.com/sportly/sitemap.xml
  - TrendPulse: https://bidbes.com/trend/sitemap.xml

## Frequently Asked Questions

**What is BidBes?**
BidBes is a free all-in-one digital services hub at https://bidbes.com combining an AI assistant, AI content and academic writing tools, a marketplace with live auctions, a gamer social network, sports scores and news, live trending searches, real-time gold/FX/crypto market signals, music streaming, a video downloader, and privacy-first browser tools for PDFs and QR codes — all under a single sign-on identity.

**Does BidBes offer financial market signals?**
Yes. Signal at https://bidbes.com/signal/ publishes live BUY/SELL/HOLD assessments with entry, stop-loss and take-profit levels plus walk-forward backtest evidence for gold, silver, major currencies and crypto across 14 markets, including Iran's TGJU network. It is informational market intelligence, not guaranteed financial advice.

**Is BidBes free?**
Yes. Every service in the ecosystem is free to use.

**Do the tools upload my files to a server?**
PDF Tools and QR Code Generator run 100% client-side — files never leave the browser. Downloder processes links server-side but requires no sign-up.

**Which AI models power BidBes?**
The central AI Chatbot supports Google Gemini, OpenCode and Kilo models; Content Engine and ISI Article Maker delegate their AI generation to this backend.

**How do I navigate the ecosystem?**
Every service lives under its own path on bidbes.com (e.g. /auction/, /nexus/), and the hub at https://bidbes.com links to all of them with live health status.

## Contact

- Website: https://bidbes.com
- Telegram: @bidbes
- Instagram: @bidbes
- LinkedIn: /company/bidbes