feat: enrich RSS items without IDs via TMDB title search

Items from RSS feeds that have no media ID (tmdb/imdb/tvdb) are now
enriched automatically using TMDB's search API. The release name is
parsed to extract a clean title and year, then searched against TMDB
to retrieve the TMDB ID before validation.

- Add media/tmdb package with SearchMovies, SearchShows, and
  ExtractTitleAndYear (parses torrent release names)
- Add EnrichFeedItemWithTmdbId to media.Client, called in rss/process.go
  before the ID validation switch
- Add --run-now flag to nabarr run to trigger all feeds immediately
- Wire media.Client through rss.Client and rssJob
- Merge feature/add-tag-option (tag support for Sonarr/Radarr)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

media/client.go

@@ -2,33 +2,87 @@ package media
 
 import (
 	"fmt"
+	"strconv"
+	"strings"
 
 	"github.com/rs/zerolog"
 
 	"github.com/l3uddz/nabarr/logger"
 	"github.com/l3uddz/nabarr/media/omdb"
+	"github.com/l3uddz/nabarr/media/tmdb"
 	"github.com/l3uddz/nabarr/media/trakt"
 	"github.com/l3uddz/nabarr/media/tvdb"
+	"github.com/l3uddz/nabarr/util"
 )
 
 type Client struct {
 	trakt *trakt.Client
 	omdb  *omdb.Client
 	tvdb  *tvdb.Client
+	tmdb  *tmdb.Client
 
 	log zerolog.Logger
 }
 
+func (c *Client) EnrichFeedItemWithTmdbId(item *FeedItem) {
+	if c.tmdb == nil {
+		return
+	}
+
+	// skip if a valid ID is already present
+	hasId := (item.TvdbId != "" && !util.StringSliceContains([]string{"0", "1"}, item.TvdbId)) ||
+		(item.ImdbId != "" && strings.HasPrefix(item.ImdbId, "tt")) ||
+		(item.TmdbId != "" && !util.StringSliceContains([]string{"0", "1"}, item.TmdbId))
+	if hasId {
+		return
+	}
+
+	title, year := tmdb.ExtractTitleAndYear(item.Title)
+	if title == "" {
+		return
+	}
+
+	var tmdbId int
+	switch {
+	case util.ContainsMovieCategory(item.Categories):
+		if id, err := c.tmdb.SearchMovies(title, year); err == nil && id > 0 {
+			tmdbId = id
+		}
+	case util.ContainsTvCategory(item.Categories):
+		if id, err := c.tmdb.SearchShows(title, year); err == nil && id > 0 {
+			tmdbId = id
+		}
+	default:
+		return
+	}
+
+	if tmdbId > 0 {
+		item.TmdbId = strconv.Itoa(tmdbId)
+		c.log.Info().
+			Str("release", item.Title).
+			Str("clean_title", title).
+			Int("year", year).
+			Int("tmdb_id", tmdbId).
+			Msg("Enriched item with TMDB ID via title search")
+	}
+}
+
 func New(cfg *Config) (*Client, error) {
 	// validate trakt configured (it is mandatory)
 	if cfg.Trakt.ClientId == "" {
 		return nil, fmt.Errorf("trakt: no client_id specified")
 	}
 
+	var tmdbClient *tmdb.Client
+	if cfg.Tmdb.ApiKey != "" {
+		tmdbClient = tmdb.New(&cfg.Tmdb)
+	}
+
 	return &Client{
 		trakt: trakt.New(&cfg.Trakt),
 		omdb:  omdb.New(&cfg.Omdb),
 		tvdb:  tvdb.New(&cfg.Tvdb),
+		tmdb:  tmdbClient,
 
 		log: logger.Child(logger.WithLevel(cfg.Verbosity)),
 	}, nil

media/config.go

@@ -2,6 +2,7 @@ package media
 
 import (
 	"github.com/l3uddz/nabarr/media/omdb"
+	"github.com/l3uddz/nabarr/media/tmdb"
 	"github.com/l3uddz/nabarr/media/trakt"
 	"github.com/l3uddz/nabarr/media/tvdb"
 )
@@ -10,6 +11,7 @@ type Config struct {
 	Trakt trakt.Config `yaml:"trakt"`
 	Omdb  omdb.Config  `yaml:"omdb"`
 	Tvdb  tvdb.Config  `yaml:"tvdb"`
+	Tmdb  tmdb.Config  `yaml:"tmdb"`
 
 	Verbosity string `yaml:"verbosity,omitempty"`
 }

media/tmdb/config.go

@@ -0,0 +1,7 @@
+package tmdb
+
+type Config struct {
+	ApiKey string `yaml:"api_key"`
+
+	Verbosity string `yaml:"verbosity,omitempty"`
+}

media/tmdb/media.go

@@ -0,0 +1,87 @@
+package tmdb
+
+import (
+	"encoding/json"
+	"errors"
+	"fmt"
+	"net/url"
+	"strconv"
+
+	"github.com/lucperkins/rek"
+
+	"github.com/l3uddz/nabarr/util"
+)
+
+var ErrItemNotFound = errors.New("not found")
+
+func (c *Client) SearchMovies(title string, year int) (int, error) {
+	vals := url.Values{
+		"api_key": []string{c.apiKey},
+		"query":   []string{title},
+	}
+	if year > 0 {
+		vals.Set("year", strconv.Itoa(year))
+	}
+
+	reqUrl, err := util.URLWithQuery(util.JoinURL(c.apiURL, "search", "movie"), vals)
+	if err != nil {
+		return 0, fmt.Errorf("generate search movie url: %w", err)
+	}
+
+	resp, err := rek.Get(reqUrl, rek.Client(c.http))
+	if err != nil {
+		return 0, fmt.Errorf("request search movie: %w", err)
+	}
+	defer resp.Body().Close()
+
+	if resp.StatusCode() != 200 {
+		return 0, fmt.Errorf("validate search movie response: %s", resp.Status())
+	}
+
+	b := new(movieSearchResponse)
+	if err := json.NewDecoder(resp.Body()).Decode(b); err != nil {
+		return 0, fmt.Errorf("decode search movie response: %w", err)
+	}
+
+	if len(b.Results) < 1 {
+		return 0, ErrItemNotFound
+	}
+
+	return b.Results[0].Id, nil
+}
+
+func (c *Client) SearchShows(title string, year int) (int, error) {
+	vals := url.Values{
+		"api_key": []string{c.apiKey},
+		"query":   []string{title},
+	}
+	if year > 0 {
+		vals.Set("first_air_date_year", strconv.Itoa(year))
+	}
+
+	reqUrl, err := util.URLWithQuery(util.JoinURL(c.apiURL, "search", "tv"), vals)
+	if err != nil {
+		return 0, fmt.Errorf("generate search tv url: %w", err)
+	}
+
+	resp, err := rek.Get(reqUrl, rek.Client(c.http))
+	if err != nil {
+		return 0, fmt.Errorf("request search tv: %w", err)
+	}
+	defer resp.Body().Close()
+
+	if resp.StatusCode() != 200 {
+		return 0, fmt.Errorf("validate search tv response: %s", resp.Status())
+	}
+
+	b := new(tvSearchResponse)
+	if err := json.NewDecoder(resp.Body()).Decode(b); err != nil {
+		return 0, fmt.Errorf("decode search tv response: %w", err)
+	}
+
+	if len(b.Results) < 1 {
+		return 0, ErrItemNotFound
+	}
+
+	return b.Results[0].Id, nil
+}

media/tmdb/parse.go

@@ -0,0 +1,25 @@
+package tmdb
+
+import (
+	"regexp"
+	"strconv"
+	"strings"
+)
+
+var yearRegex = regexp.MustCompile(`\b(19|20)\d{2}\b`)
+
+// ExtractTitleAndYear parses a torrent release name and returns the clean title and year.
+// Example: "The.Housemaid.2025.FRENCH.1080p" → ("The Housemaid", 2025)
+func ExtractTitleAndYear(releaseName string) (string, int) {
+	s := strings.ReplaceAll(releaseName, ".", " ")
+	s = strings.ReplaceAll(s, "_", " ")
+
+	loc := yearRegex.FindStringIndex(s)
+	if loc == nil {
+		return strings.TrimSpace(s), 0
+	}
+
+	year, _ := strconv.Atoi(s[loc[0]:loc[1]])
+	title := strings.TrimSpace(s[:loc[0]])
+	return title, year
+}

media/tmdb/struct.go

@@ -0,0 +1,13 @@
+package tmdb
+
+type movieSearchResponse struct {
+	Results []struct {
+		Id int `json:"id"`
+	} `json:"results"`
+}
+
+type tvSearchResponse struct {
+	Results []struct {
+		Id int `json:"id"`
+	} `json:"results"`
+}

media/tmdb/tmdb.go

@@ -0,0 +1,33 @@
+package tmdb
+
+import (
+	"net/http"
+	"time"
+
+	"github.com/rs/zerolog"
+	"go.uber.org/ratelimit"
+
+	"github.com/l3uddz/nabarr/logger"
+	"github.com/l3uddz/nabarr/util"
+)
+
+type Client struct {
+	log  zerolog.Logger
+	http *http.Client
+
+	apiKey string
+	apiURL string
+}
+
+func New(cfg *Config) *Client {
+	l := logger.Child(logger.WithLevel(cfg.Verbosity)).With().
+		Str("media", "tmdb").Logger()
+
+	return &Client{
+		log:  l,
+		http: util.NewRetryableHttpClient(30*time.Second, ratelimit.New(5, ratelimit.WithoutSlack), &l),
+
+		apiKey: cfg.ApiKey,
+		apiURL: "https://api.themoviedb.org/3",
+	}
+}

media/trakt/parse.go

@@ -0,0 +1 @@
+package trakt