388 lines
13 KiB
Go
388 lines
13 KiB
Go
// Copyright 2025 eat-pray-ai & OpenWaygate
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
|
|
package search
|
|
|
|
import (
|
|
"bytes"
|
|
"context"
|
|
"encoding/json"
|
|
"io"
|
|
"log/slog"
|
|
"time"
|
|
|
|
"github.com/eat-pray-ai/yutu/cmd"
|
|
"github.com/eat-pray-ai/yutu/pkg"
|
|
"github.com/eat-pray-ai/yutu/pkg/search"
|
|
"github.com/eat-pray-ai/yutu/pkg/utils"
|
|
"github.com/google/jsonschema-go/jsonschema"
|
|
"github.com/modelcontextprotocol/go-sdk/mcp"
|
|
"github.com/spf13/cobra"
|
|
)
|
|
|
|
const (
|
|
listTool = "search-list"
|
|
)
|
|
|
|
type listIn struct {
|
|
ChannelId string `json:"channelId"`
|
|
ChannelType string `json:"channelType"`
|
|
EventType string `json:"eventType"`
|
|
ForContentOwner *string `json:"forContentOwner,omitempty"`
|
|
ForDeveloper *string `json:"forDeveloper,omitempty"`
|
|
ForMine *string `json:"forMine,omitempty"`
|
|
Location string `json:"location"`
|
|
LocationRadius string `json:"locationRadius"`
|
|
MaxResults int64 `json:"maxResults"`
|
|
OnBehalfOfContentOwner string `json:"onBehalfOfContentOwner"`
|
|
Order string `json:"order"`
|
|
PublishedAfter string `json:"publishedAfter"`
|
|
PublishedBefore string `json:"publishedBefore"`
|
|
Q string `json:"q"`
|
|
RegionCode string `json:"regionCode"`
|
|
RelevanceLanguage string `json:"relevanceLanguage"`
|
|
SafeSearch string `json:"safeSearch"`
|
|
TopicId string `json:"topicId"`
|
|
Types []string `json:"types"`
|
|
VideoCaption string `json:"videoCaption"`
|
|
VideoCategoryId string `json:"videoCategoryId"`
|
|
VideoDefinition string `json:"videoDefinition"`
|
|
VideoDimension string `json:"videoDimension"`
|
|
VideoDuration string `json:"videoDuration"`
|
|
VideoEmbeddable string `json:"videoEmbeddable"`
|
|
VideoLicense string `json:"videoLicense"`
|
|
VideoPaidProductPlacement string `json:"videoPaidProductPlacement"`
|
|
VideoSyndicated string `json:"videoSyndicated"`
|
|
VideoType string `json:"videoType"`
|
|
Parts []string `json:"parts"`
|
|
Output string `json:"output"`
|
|
Jsonpath string `json:"jsonpath"`
|
|
}
|
|
|
|
var listInSchema = &jsonschema.Schema{
|
|
Type: "object",
|
|
Required: []string{
|
|
"channelId", "channelType", "eventType", "forContentOwner", "forDeveloper",
|
|
"forMine", "location", "locationRadius", "maxResults",
|
|
"onBehalfOfContentOwner",
|
|
"order", "publishedAfter", "publishedBefore", "q", "regionCode",
|
|
"relevanceLanguage", "safeSearch", "topicId", "types", "videoCaption",
|
|
"videoCategoryId", "videoDefinition", "videoDimension", "videoDuration",
|
|
"videoEmbeddable", "videoLicense", "videoPaidProductPlacement",
|
|
"videoSyndicated",
|
|
"videoType", "parts", "output", "jsonpath",
|
|
},
|
|
Properties: map[string]*jsonschema.Schema{
|
|
"channelId": {
|
|
Type: "string", Description: cidUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"channelType": {
|
|
Type: "string", Enum: []any{"channelTypeUnspecified", "any", "show"},
|
|
Description: ctUsage, Default: json.RawMessage(`"channelTypeUnspecified"`),
|
|
},
|
|
"eventType": {
|
|
Type: "string", Enum: []any{"none", "upcoming", "live", "completed"},
|
|
Description: etUsage, Default: json.RawMessage(`"none"`),
|
|
},
|
|
"forContentOwner": {
|
|
Type: "string", Enum: []any{"true", "false", ""},
|
|
Description: fcoUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"forDeveloper": {
|
|
Type: "string", Enum: []any{"true", "false", ""},
|
|
Description: fdUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"forMine": {
|
|
Type: "string", Enum: []any{"true", "false", ""},
|
|
Description: fmUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"location": {
|
|
Type: "string", Description: locationUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"locationRadius": {
|
|
Type: "string", Description: lrUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"maxResults": {
|
|
Type: "number", Description: pkg.MRUsage,
|
|
Default: json.RawMessage("5"),
|
|
Minimum: jsonschema.Ptr(float64(0)),
|
|
},
|
|
"onBehalfOfContentOwner": {
|
|
Type: "string", Description: "",
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"order": {
|
|
Type: "string", Description: orderUsage,
|
|
Default: json.RawMessage(`"relevance"`),
|
|
},
|
|
"publishedAfter": {
|
|
Type: "string", Description: paUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"publishedBefore": {
|
|
Type: "string", Description: pbUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"q": {
|
|
Type: "string", Description: qUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"regionCode": {
|
|
Type: "string", Description: rcUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"relevanceLanguage": {
|
|
Type: "string", Description: rlUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"safeSearch": {
|
|
Type: "string",
|
|
Enum: []any{
|
|
"safeSearchSettingUnspecified", "none", "moderate", "strict",
|
|
},
|
|
Description: ssUsage, Default: json.RawMessage(`"moderate"`),
|
|
},
|
|
"topicId": {
|
|
Type: "string", Description: tidUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"types": {
|
|
Type: "array", Items: &jsonschema.Schema{
|
|
Type: "string",
|
|
},
|
|
Description: typesUsage,
|
|
Default: json.RawMessage(`[]`),
|
|
},
|
|
"videoCaption": {
|
|
Type: "string",
|
|
Enum: []any{
|
|
"videoCaptionUnspecified", "any", "closedCaption", "none",
|
|
},
|
|
Description: vcUsage, Default: json.RawMessage(`"any"`),
|
|
},
|
|
"videoCategoryId": {
|
|
Type: "string", Description: vcidUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"videoDefinition": {
|
|
Type: "string", Description: vdeUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
"videoDimension": {
|
|
Type: "string", Enum: []any{"any", "2d", "3d"},
|
|
Description: vdiUsage, Default: json.RawMessage(`"any"`),
|
|
},
|
|
"videoDuration": {
|
|
Type: "string",
|
|
Enum: []any{
|
|
"videoDurationUnspecified", "any", "short", "medium", "long",
|
|
},
|
|
Description: vduUsage, Default: json.RawMessage(`"any"`),
|
|
},
|
|
"videoEmbeddable": {
|
|
Type: "string",
|
|
Enum: []any{"videoEmbeddableUnspecified", "any", "true", ""},
|
|
Description: veUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"videoLicense": {
|
|
Type: "string", Enum: []any{"any", "youtube", "creativeCommon", ""},
|
|
Description: vlUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"videoPaidProductPlacement": {
|
|
Type: "string",
|
|
Enum: []any{
|
|
"videoPaidProductPlacementUnspecified", "any", "true", "",
|
|
},
|
|
Description: vpppUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"videoSyndicated": {
|
|
Type: "string",
|
|
Enum: []any{"videoSyndicatedUnspecified", "any", "true", ""},
|
|
Description: vsUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"videoType": {
|
|
Type: "string",
|
|
Enum: []any{"videoTypeUnspecified", "any", "movie", "episode", ""},
|
|
Description: vtUsage, Default: json.RawMessage(`""`),
|
|
},
|
|
"parts": {
|
|
Type: "array", Items: &jsonschema.Schema{
|
|
Type: "string",
|
|
},
|
|
Description: pkg.PartsUsage,
|
|
Default: json.RawMessage(`["id","snippet"]`),
|
|
},
|
|
"output": {
|
|
Type: "string", Enum: []any{"json", "yaml", "table"},
|
|
Description: pkg.TableUsage, Default: json.RawMessage(`"yaml"`),
|
|
},
|
|
"jsonpath": {
|
|
Type: "string", Description: pkg.JPUsage,
|
|
Default: json.RawMessage(`""`),
|
|
},
|
|
},
|
|
}
|
|
|
|
func init() {
|
|
mcp.AddTool(
|
|
cmd.Server, &mcp.Tool{
|
|
Name: listTool, Title: short, Description: long,
|
|
InputSchema: listInSchema, Annotations: &mcp.ToolAnnotations{
|
|
DestructiveHint: jsonschema.Ptr(false),
|
|
IdempotentHint: true,
|
|
OpenWorldHint: jsonschema.Ptr(true),
|
|
ReadOnlyHint: true,
|
|
},
|
|
}, listHandler,
|
|
)
|
|
searchCmd.AddCommand(listCmd)
|
|
|
|
listCmd.Flags().StringVar(&channelId, "channelId", "", cidUsage)
|
|
listCmd.Flags().StringVar(
|
|
&channelType, "channelType", "channelTypeUnspecified", ctUsage,
|
|
)
|
|
listCmd.Flags().StringVar(&eventType, "eventType", "none", etUsage)
|
|
listCmd.Flags().BoolVar(
|
|
forContentOwner, "forContentOwner", false, fcoUsage,
|
|
)
|
|
listCmd.Flags().BoolVar(forDeveloper, "forDeveloper", false, fdUsage)
|
|
listCmd.Flags().BoolVar(forMine, "forMine", false, fmUsage)
|
|
listCmd.Flags().StringVar(&location, "location", "", locationUsage)
|
|
listCmd.Flags().StringVar(&locationRadius, "locationRadius", "", lrUsage)
|
|
listCmd.Flags().Int64Var(&maxResults, "maxResults", 5, pkg.MRUsage)
|
|
listCmd.Flags().StringVar(
|
|
&onBehalfOfContentOwner, "onBehalfOfContentOwner", "", "",
|
|
)
|
|
listCmd.Flags().StringVar(&order, "order", "relevance", orderUsage)
|
|
listCmd.Flags().StringVar(&publishedAfter, "publishedAfter", "", paUsage)
|
|
listCmd.Flags().StringVar(&publishedBefore, "publishedBefore", "", pbUsage)
|
|
listCmd.Flags().StringVar(&q, "q", "", qUsage)
|
|
listCmd.Flags().StringVar(®ionCode, "regionCode", "", rcUsage)
|
|
listCmd.Flags().StringVar(&relevanceLanguage, "relevanceLanguage", "", rlUsage)
|
|
listCmd.Flags().StringVar(&safeSearch, "safeSearch", "moderate", ssUsage)
|
|
listCmd.Flags().StringVar(&topicId, "topicId", "", tidUsage)
|
|
listCmd.Flags().StringSliceVar(&types, "types", []string{}, typesUsage)
|
|
listCmd.Flags().StringVar(&videoCaption, "videoCaption", "any", vcUsage)
|
|
listCmd.Flags().StringVar(&videoCategoryId, "videoCategoryId", "", vcidUsage)
|
|
listCmd.Flags().StringVar(&videoDefinition, "videoDefinition", "", vdeUsage)
|
|
listCmd.Flags().StringVar(&videoDimension, "videoDimension", "any", vdiUsage)
|
|
listCmd.Flags().StringVar(&videoDuration, "videoDuration", "any", vduUsage)
|
|
listCmd.Flags().StringVar(&videoEmbeddable, "videoEmbeddable", "", veUsage)
|
|
listCmd.Flags().StringVar(&videoLicense, "videoLicense", "", vlUsage)
|
|
listCmd.Flags().StringVar(
|
|
&videoPaidProductPlacement, "videoPaidProductPlacement", "", vpppUsage,
|
|
)
|
|
listCmd.Flags().StringVar(&videoSyndicated, "videoSyndicated", "", vsUsage)
|
|
listCmd.Flags().StringVar(&videoType, "videoType", "", vtUsage)
|
|
listCmd.Flags().StringSliceVar(
|
|
&parts, "parts", []string{"id", "snippet"}, pkg.PartsUsage,
|
|
)
|
|
listCmd.Flags().StringVar(&output, "output", "table", pkg.TableUsage)
|
|
listCmd.Flags().StringVar(&jpath, "jsonpath", "", pkg.JPUsage)
|
|
}
|
|
|
|
var listCmd = &cobra.Command{
|
|
Use: "list",
|
|
Short: short,
|
|
Long: long,
|
|
Run: func(cmd *cobra.Command, args []string) {
|
|
err := list(cmd.OutOrStdout())
|
|
if err != nil {
|
|
_ = cmd.Help()
|
|
cmd.PrintErrf("Error: %v\n", err)
|
|
}
|
|
},
|
|
}
|
|
|
|
func listHandler(
|
|
ctx context.Context, req *mcp.CallToolRequest, input listIn,
|
|
) (*mcp.CallToolResult, any, error) {
|
|
logger := slog.New(
|
|
mcp.NewLoggingHandler(
|
|
req.Session,
|
|
&mcp.LoggingHandlerOptions{LoggerName: listTool, MinInterval: time.Second},
|
|
),
|
|
)
|
|
|
|
channelId = input.ChannelId
|
|
channelType = input.ChannelType
|
|
eventType = input.EventType
|
|
forContentOwner = utils.BoolPtr(*input.ForContentOwner)
|
|
forDeveloper = utils.BoolPtr(*input.ForDeveloper)
|
|
forMine = utils.BoolPtr(*input.ForMine)
|
|
location = input.Location
|
|
locationRadius = input.LocationRadius
|
|
maxResults = input.MaxResults
|
|
onBehalfOfContentOwner = input.OnBehalfOfContentOwner
|
|
order = input.Order
|
|
publishedAfter = input.PublishedAfter
|
|
publishedBefore = input.PublishedBefore
|
|
q = input.Q
|
|
regionCode = input.RegionCode
|
|
relevanceLanguage = input.RelevanceLanguage
|
|
safeSearch = input.SafeSearch
|
|
topicId = input.TopicId
|
|
types = input.Types
|
|
videoCaption = input.VideoCaption
|
|
videoCategoryId = input.VideoCategoryId
|
|
videoDefinition = input.VideoDefinition
|
|
videoDimension = input.VideoDimension
|
|
videoDuration = input.VideoDuration
|
|
videoEmbeddable = input.VideoEmbeddable
|
|
videoLicense = input.VideoLicense
|
|
videoPaidProductPlacement = input.VideoPaidProductPlacement
|
|
videoSyndicated = input.VideoSyndicated
|
|
videoType = input.VideoType
|
|
parts = input.Parts
|
|
output = input.Output
|
|
jpath = input.Jsonpath
|
|
|
|
var writer bytes.Buffer
|
|
err := list(&writer)
|
|
if err != nil {
|
|
logger.ErrorContext(ctx, err.Error(), "input", input)
|
|
return nil, nil, err
|
|
}
|
|
return &mcp.CallToolResult{Content: []mcp.Content{&mcp.TextContent{Text: writer.String()}}}, nil, nil
|
|
}
|
|
|
|
func list(writer io.Writer) error {
|
|
s := search.NewSearch(
|
|
search.WithChannelId(channelId),
|
|
search.WithChannelType(channelType),
|
|
search.WithEventType(eventType),
|
|
search.WithForContentOwner(forContentOwner),
|
|
search.WithForDeveloper(forDeveloper),
|
|
search.WithForMine(forMine),
|
|
search.WithLocation(location),
|
|
search.WithLocationRadius(locationRadius),
|
|
search.WithMaxResults(maxResults),
|
|
search.WithOnBehalfOfContentOwner(onBehalfOfContentOwner),
|
|
search.WithOrder(order),
|
|
search.WithPublishedAfter(publishedAfter),
|
|
search.WithPublishedBefore(publishedBefore),
|
|
search.WithQ(q),
|
|
search.WithRegionCode(regionCode),
|
|
search.WithRelevanceLanguage(relevanceLanguage),
|
|
search.WithSafeSearch(safeSearch),
|
|
search.WithTopicId(topicId),
|
|
search.WithTypes(types),
|
|
search.WithVideoCaption(videoCaption),
|
|
search.WithVideoCategoryId(videoCategoryId),
|
|
search.WithVideoDefinition(videoDefinition),
|
|
search.WithVideoDimension(videoDimension),
|
|
search.WithVideoDuration(videoDuration),
|
|
search.WithVideoEmbeddable(videoEmbeddable),
|
|
search.WithVideoLicense(videoLicense),
|
|
search.WithVideoPaidProductPlacement(videoPaidProductPlacement),
|
|
search.WithVideoSyndicated(videoSyndicated),
|
|
search.WithVideoType(videoType),
|
|
search.WithService(nil),
|
|
)
|
|
|
|
return s.List(parts, output, jpath, writer)
|
|
}
|