52 lines
1.3 KiB
TypeScript
52 lines
1.3 KiB
TypeScript
|
export type SearchType = "threads_keyword" | "web_search" | "crawler";
|
|||
|
|
|
|||
|
|
export type KeywordPriority = "high" | "medium" | "low";
|
|||
|
|
|
|||
|
|
export type SearchProviderName = "threads" | "brave" | "crawler";
|
|||
|
|
|
|||
|
|
export interface SearchRequest {
|
|||
|
|
keyword: string;
|
|||
|
|
limit: number;
|
|||
|
|
since?: Date;
|
|||
|
|
source: SearchProviderName;
|
|||
|
|
searchType: SearchType;
|
|||
|
|
priority?: KeywordPriority;
|
|||
|
|
/** 直接指定 Brave 查詢（略過 keyword query builder） */
|
|||
|
|
query?: string;
|
|||
|
|
/** 巡邏模式：檢查 high priority + 每日額度（預設 true） */
|
|||
|
|
patrolMode?: boolean;
|
|||
|
|
/** 僅保留 threads.com 結果（預設 true） */
|
|||
|
|
threadsOnly?: boolean;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface SearchResult {
|
|||
|
|
title: string;
|
|||
|
|
url: string;
|
|||
|
|
snippet: string;
|
|||
|
|
author: string;
|
|||
|
|
publishedAt?: Date;
|
|||
|
|
source: SearchProviderName;
|
|||
|
|
threadId?: string;
|
|||
|
|
raw?: Record<string, unknown>;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface SearchResponse {
|
|||
|
|
provider: SearchProviderName;
|
|||
|
|
results: SearchResult[];
|
|||
|
|
status: "success" | "unavailable" | "skipped";
|
|||
|
|
skipReason?: string;
|
|||
|
|
quotaUsed?: number;
|
|||
|
|
quotaLimit?: number;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface KeywordInput {
|
|||
|
|
value: string;
|
|||
|
|
limit: number;
|
|||
|
|
priority: KeywordPriority;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
export interface SearchProvider {
|
|||
|
|
name(): SearchProviderName;
|
|||
|
|
enabled(): boolean;
|
|||
|
|
search(req: SearchRequest): Promise<SearchResponse>;
|
|||
|
|
}
|