@cyanheads/finnhub-mcp-server 0.1.6 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/AGENTS.md +21 -9
  2. package/CLAUDE.md +21 -9
  3. package/Dockerfile +7 -3
  4. package/README.md +46 -101
  5. package/changelog/0.2.x/0.2.0.md +35 -0
  6. package/changelog/0.2.x/0.2.1.md +35 -0
  7. package/changelog/template.md +10 -3
  8. package/dist/index.js +2 -1
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +12 -2
  11. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
  12. package/dist/mcp-server/tools/definitions/get-company.tool.js +16 -8
  13. package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -1
  14. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts +25 -2
  15. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -1
  16. package/dist/mcp-server/tools/definitions/get-earnings.tool.js +88 -42
  17. package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
  18. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts +16 -0
  19. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -1
  20. package/dist/mcp-server/tools/definitions/get-news.tool.js +90 -34
  21. package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -1
  22. package/dist/mcp-server/tools/definitions/get-quote.tool.d.ts.map +1 -1
  23. package/dist/mcp-server/tools/definitions/get-quote.tool.js +4 -2
  24. package/dist/mcp-server/tools/definitions/get-quote.tool.js.map +1 -1
  25. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts +1 -1
  26. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts.map +1 -1
  27. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js +7 -6
  28. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
  29. package/dist/mcp-server/tools/definitions/index.d.ts +93 -42
  30. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  31. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts +2 -0
  32. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts.map +1 -1
  33. package/dist/mcp-server/tools/definitions/search-symbols.tool.js +28 -18
  34. package/dist/mcp-server/tools/definitions/search-symbols.tool.js.map +1 -1
  35. package/dist/mcp-server/tools/definitions/window-page.d.ts +21 -0
  36. package/dist/mcp-server/tools/definitions/window-page.d.ts.map +1 -0
  37. package/dist/mcp-server/tools/definitions/window-page.js +39 -0
  38. package/dist/mcp-server/tools/definitions/window-page.js.map +1 -0
  39. package/dist/services/finnhub/date-window.d.ts +13 -0
  40. package/dist/services/finnhub/date-window.d.ts.map +1 -0
  41. package/dist/services/finnhub/date-window.js +32 -0
  42. package/dist/services/finnhub/date-window.js.map +1 -0
  43. package/dist/services/finnhub/finnhub-service.d.ts +4 -4
  44. package/dist/services/finnhub/finnhub-service.d.ts.map +1 -1
  45. package/dist/services/finnhub/finnhub-service.js +6 -6
  46. package/dist/services/finnhub/finnhub-service.js.map +1 -1
  47. package/dist/services/finnhub/normalize-article-text.d.ts +6 -0
  48. package/dist/services/finnhub/normalize-article-text.d.ts.map +1 -0
  49. package/dist/services/finnhub/normalize-article-text.js +97 -0
  50. package/dist/services/finnhub/normalize-article-text.js.map +1 -0
  51. package/dist/services/finnhub/types.d.ts +3 -3
  52. package/dist/services/finnhub/types.d.ts.map +1 -1
  53. package/package.json +15 -11
  54. package/server.json +3 -3
  55. package/skills/finnhub-guide/SKILL.md +31 -0
@@ -5,11 +5,12 @@
5
5
  * @module mcp-server/tools/definitions/search-symbols.tool
6
6
  */
7
7
  import { tool, z } from '@cyanheads/mcp-ts-core';
8
+ import { escapeMarkdownInline } from '@cyanheads/mcp-ts-core/utils';
8
9
  import { getFinnhubService } from '../../../services/finnhub/finnhub-service.js';
9
10
  /** Finnhub uses `.A` and `.B` for US class-share symbols as well as dots for exchanges. */
10
11
  const US_CLASS_SHARE_SYMBOL = /^[A-Z]+\.[AB]$/;
11
12
  export const searchSymbols = tool('finnhub_search_symbols', {
12
- description: 'Resolve a company name or partial ticker to Finnhub stock symbols. The entry point for every other tool — users say "Microsoft", the rest of the surface needs "MSFT". Returns matched symbols with display symbol, description, and security type, best likely-US match first. Each result carries isLikelyUS, a symbol-format heuristic for likely free-tier availability; quote and profile responses remain authoritative.',
13
+ description: 'Resolve a company name or partial ticker to Finnhub stock symbols. Returns matched symbols with display symbol, description, and security type. Exact ticker matches rank first, then likely-US Common Stock. Each result carries isLikelyUS, a symbol-format heuristic for likely free-tier availability; quote and profile responses remain authoritative.',
13
14
  annotations: { readOnlyHint: true, openWorldHint: true },
14
15
  input: z.object({
15
16
  query: z
@@ -25,9 +26,14 @@ export const searchSymbols = tool('finnhub_search_symbols', {
25
26
  .min(1)
26
27
  .max(50)
27
28
  .default(10)
28
- .describe('Max symbols to return (Finnhub often returns 10–50 matches for a common word). Default 10. Likely-US Common Stock matches are surfaced first.'),
29
+ .describe('Max symbols to return after ranking. Default 10.'),
30
+ exchange: z
31
+ .string()
32
+ .optional()
33
+ .describe('Finnhub exchange code, e.g. "US" for US listings. Omit or leave blank for global search. A filtered company-name search can miss listings found by a ticker search.'),
29
34
  }),
30
35
  output: z.object({
36
+ exchange: z.string().optional().describe('Exchange filter sent to Finnhub, when applied.'),
31
37
  results: z
32
38
  .array(z
33
39
  .object({
@@ -46,7 +52,7 @@ export const searchSymbols = tool('finnhub_search_symbols', {
46
52
  .describe('Symbol-format heuristic for likely US free-tier availability. Plain tickers and `.A`/`.B` class-share symbols are likely US; recognized exchange suffixes such as `.SS`, `.T`, and `.L` are not. Quote and profile responses remain authoritative.'),
47
53
  })
48
54
  .describe('A single matched symbol.'))
49
- .describe('Matched symbols, likely-US Common Stock first, then by Finnhub order.'),
55
+ .describe('Exact ticker matches first, then likely-US Common Stock, then other matches. Finnhub order is preserved within each group.'),
50
56
  }),
51
57
  enrichment: {
52
58
  totalCount: z
@@ -61,7 +67,8 @@ export const searchSymbols = tool('finnhub_search_symbols', {
61
67
  notice: z.string().optional().describe('Guidance when nothing matched the query.'),
62
68
  },
63
69
  async handler(input, ctx) {
64
- const { count, result } = await getFinnhubService().search(input.query, ctx);
70
+ const exchange = input.exchange?.trim().toUpperCase() || undefined;
71
+ const { count, result } = await getFinnhubService().search(input.query, ctx, exchange);
65
72
  const mapped = result.map((match) => ({
66
73
  symbol: match.symbol,
67
74
  displaySymbol: match.displaySymbol,
@@ -69,17 +76,18 @@ export const searchSymbols = tool('finnhub_search_symbols', {
69
76
  type: match.type,
70
77
  isLikelyUS: !match.symbol.includes('.') || US_CLASS_SHARE_SYMBOL.test(match.symbol),
71
78
  }));
72
- /**
73
- * Stable sort: likely-US Common Stock first, preserving Finnhub's order
74
- * within each group. ETFs and ETPs deliberately retain Finnhub's rank.
75
- */
76
- const rank = (r) => r.isLikelyUS && r.type === 'Common Stock' ? 0 : 1;
77
- const sorted = [...mapped].sort((a, b) => rank(a) - rank(b));
79
+ const query = input.query.toUpperCase();
80
+ const rank = (r) => {
81
+ if (r.symbol.toUpperCase() === query || r.displaySymbol.toUpperCase() === query)
82
+ return 0;
83
+ return r.isLikelyUS && r.type === 'Common Stock' ? 1 : 2;
84
+ };
85
+ mapped.sort((a, b) => rank(a) - rank(b));
78
86
  ctx.enrich.total(count);
79
87
  if (count === 0) {
80
88
  ctx.enrich.notice(`No symbols matched "${input.query}". Try the company's common name or a ticker fragment.`);
81
89
  }
82
- const results = sorted.slice(0, input.limit);
90
+ const results = mapped.slice(0, input.limit);
83
91
  if (count > input.limit) {
84
92
  ctx.enrich.truncated({ shown: results.length, cap: input.limit });
85
93
  }
@@ -88,19 +96,21 @@ export const searchSymbols = tool('finnhub_search_symbols', {
88
96
  count,
89
97
  returned: results.length,
90
98
  });
91
- return { results };
99
+ return { ...(exchange && { exchange }), results };
92
100
  },
93
101
  format: (result) => {
94
- if (result.results.length === 0) {
95
- return [{ type: 'text', text: 'No matching symbols.' }];
96
- }
97
- const lines = result.results.map((r) => {
102
+ const lines = [];
103
+ if (result.exchange)
104
+ lines.push(`Exchange: ${escapeMarkdownInline(result.exchange)}`, '');
105
+ if (result.results.length === 0)
106
+ lines.push('No matching symbols.');
107
+ for (const r of result.results) {
98
108
  const region = r.isLikelyUS
99
109
  ? 'likely US (symbol heuristic)'
100
110
  : 'not likely US (exchange-suffix heuristic)';
101
111
  const type = r.type || 'Unknown type';
102
- return `**${r.symbol}** — ${r.description} (${type}, ${region}) · display: ${r.displaySymbol}`;
103
- });
112
+ lines.push(`**${r.symbol}** — ${r.description} (${type}, ${region}) · display: ${r.displaySymbol}`);
113
+ }
104
114
  return [{ type: 'text', text: lines.join('\n') }];
105
115
  },
106
116
  });
@@ -1 +1 @@
1
- {"version":3,"file":"search-symbols.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search-symbols.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * @fileoverview Pages a sorted Finnhub response and reports its fetched bounds.
3
+ * @module mcp-server/tools/definitions/window-page
4
+ */
5
+ import { type Context, z } from '@cyanheads/mcp-ts-core';
6
+ /** Bounds and continuation for a paged, date-windowed tool response. */
7
+ export declare const windowPageEnrichment: {
8
+ fetchedFrom: z.ZodOptional<z.ZodString>;
9
+ fetchedTo: z.ZodOptional<z.ZodString>;
10
+ nextOffset: z.ZodOptional<z.ZodNumber>;
11
+ };
12
+ /** Slice the already sorted rows, preserving upstream warnings alongside paging guidance. */
13
+ export declare function pageWindow<T>(rows: T[], input: {
14
+ limit: number;
15
+ offset?: number | undefined;
16
+ }, ctx: Pick<Context, 'enrich'>, coverage?: {
17
+ fetchedFrom: string;
18
+ fetchedTo: string;
19
+ warning?: string;
20
+ }): T[];
21
+ //# sourceMappingURL=window-page.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window-page.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/window-page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEzD,wEAAwE;AACxE,eAAO,MAAM,oBAAoB;IAC/B,WAAW;IACX,SAAS;IACT,UAAU;CAKX,CAAC;AAEF,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,CAAC,EAC1B,IAAI,EAAE,CAAC,EAAE,EACT,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EACrD,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5B,QAAQ,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,CAAC,EAAE,CAqBL"}
@@ -0,0 +1,39 @@
1
+ /**
2
+ * @fileoverview Pages a sorted Finnhub response and reports its fetched bounds.
3
+ * @module mcp-server/tools/definitions/window-page
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ /** Bounds and continuation for a paged, date-windowed tool response. */
7
+ export const windowPageEnrichment = {
8
+ fetchedFrom: z.string().optional().describe('Earliest date or timestamp among all fetched rows.'),
9
+ fetchedTo: z.string().optional().describe('Latest date or timestamp among all fetched rows.'),
10
+ nextOffset: z
11
+ .number()
12
+ .int()
13
+ .optional()
14
+ .describe('Offset for the next page of fetched rows. Each page refetches upstream data.'),
15
+ };
16
+ /** Slice the already sorted rows, preserving upstream warnings alongside paging guidance. */
17
+ export function pageWindow(rows, input, ctx, coverage) {
18
+ const offset = input.offset ?? 0;
19
+ const page = rows.slice(offset, offset + input.limit);
20
+ ctx.enrich.total(rows.length);
21
+ if (coverage) {
22
+ ctx.enrich({ fetchedFrom: coverage.fetchedFrom, fetchedTo: coverage.fetchedTo });
23
+ }
24
+ const nextOffset = offset + page.length;
25
+ if (nextOffset < rows.length) {
26
+ const continuation = `Use offset ${nextOffset} with the same query to continue through the fetched rows.`;
27
+ ctx.enrich({ nextOffset });
28
+ ctx.enrich.truncated({
29
+ shown: page.length,
30
+ cap: input.limit,
31
+ guidance: coverage?.warning ? `${coverage.warning} ${continuation}` : continuation,
32
+ });
33
+ }
34
+ else if (coverage?.warning) {
35
+ ctx.enrich.notice(coverage.warning);
36
+ }
37
+ return page;
38
+ }
39
+ //# sourceMappingURL=window-page.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"window-page.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/window-page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEzD,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACjG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC7F,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,8EAA8E,CAAC;CAC5F,CAAC;AAEF,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CACxB,IAAS,EACT,KAAqD,EACrD,GAA4B,EAC5B,QAAuE;IAEvE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,QAAQ,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACxC,IAAI,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,cAAc,UAAU,4DAA4D,CAAC;QAC1G,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3B,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;YACnB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,GAAG,EAAE,KAAK,CAAC,KAAK;YAChB,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY;SACnF,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * @fileoverview Resolves and validates the UTC date bounds passed to Finnhub.
3
+ * @module services/finnhub/date-window
4
+ */
5
+ /** Resolve empty or omitted bounds relative to today, then validate the effective window. */
6
+ export declare function dateWindow(input: {
7
+ from?: string | undefined;
8
+ to?: string | undefined;
9
+ }, fromDays: number, toDays: number): {
10
+ from: string;
11
+ to: string;
12
+ };
13
+ //# sourceMappingURL=date-window.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"date-window.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/date-window.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,6FAA6F;AAC7F,wBAAgB,UAAU,CACxB,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAC7D,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAyB9B"}
@@ -0,0 +1,32 @@
1
+ /**
2
+ * @fileoverview Resolves and validates the UTC date bounds passed to Finnhub.
3
+ * @module services/finnhub/date-window
4
+ */
5
+ import { z } from '@cyanheads/mcp-ts-core';
6
+ import { validationError } from '@cyanheads/mcp-ts-core/errors';
7
+ const isoDate = z.iso.date();
8
+ const DAY_MS = 86_400_000;
9
+ /** Resolve empty or omitted bounds relative to today, then validate the effective window. */
10
+ export function dateWindow(input, fromDays, toDays) {
11
+ const now = Date.now();
12
+ const from = input.from || new Date(now + fromDays * DAY_MS).toISOString().slice(0, 10);
13
+ const to = input.to || new Date(now + toDays * DAY_MS).toISOString().slice(0, 10);
14
+ for (const [field, value] of Object.entries({ from, to })) {
15
+ if (!isoDate.safeParse(value).success) {
16
+ throw validationError(`${field} must be a real YYYY-MM-DD date, received ${JSON.stringify(value)}.`, {
17
+ reason: 'invalid_date',
18
+ field,
19
+ value,
20
+ });
21
+ }
22
+ }
23
+ if (from > to) {
24
+ throw validationError(`Start date ${from} must be on or before end date ${to}.`, {
25
+ reason: 'inverted_date_window',
26
+ from,
27
+ to,
28
+ });
29
+ }
30
+ return { from, to };
31
+ }
32
+ //# sourceMappingURL=date-window.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"date-window.js","sourceRoot":"","sources":["../../../src/services/finnhub/date-window.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC7B,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CACxB,KAA6D,EAC7D,QAAgB,EAChB,MAAc;IAEd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACxF,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,GAAG,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAElF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,eAAe,CACnB,GAAG,KAAK,6CAA6C,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAC7E;gBACE,MAAM,EAAE,cAAc;gBACtB,KAAK;gBACL,KAAK;aACN,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,IAAI,GAAG,EAAE,EAAE,CAAC;QACd,MAAM,eAAe,CAAC,cAAc,IAAI,kCAAkC,EAAE,GAAG,EAAE;YAC/E,MAAM,EAAE,sBAAsB;YAC9B,IAAI;YACJ,EAAE;SACH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACtB,CAAC"}
@@ -19,8 +19,8 @@ export declare class FinnhubService {
19
19
  private readonly baseUrl;
20
20
  private readonly apiKey;
21
21
  constructor();
22
- /** `GET /search?q={query}` — resolve a name/ticker fragment to symbols. */
23
- search(query: string, ctx: Context): Promise<FinnhubSearchResponse>;
22
+ /** `GET /search` — resolve a name/ticker fragment globally or on one exchange. */
23
+ search(query: string, ctx: Context, exchange?: string): Promise<FinnhubSearchResponse>;
24
24
  /** `GET /quote?symbol={symbol}` — real-time price snapshot. */
25
25
  quote(symbol: string, ctx: Context): Promise<FinnhubQuote>;
26
26
  /** `GET /stock/market-status?exchange={exchange}` — live market-open flag. */
@@ -29,8 +29,8 @@ export declare class FinnhubService {
29
29
  profile(symbol: string, ctx: Context): Promise<FinnhubProfile>;
30
30
  /** `GET /stock/metric?symbol={symbol}&metric=all` — fundamentals (~100 keys). */
31
31
  metrics(symbol: string, ctx: Context): Promise<FinnhubMetricResponse>;
32
- /** `GET /stock/peers?symbol={symbol}` — sector peer symbols (includes the query). */
33
- peers(symbol: string, ctx: Context): Promise<string[]>;
32
+ /** `GET /stock/peers` — omit grouping for Finnhub's default sub-industry peers. */
33
+ peers(symbol: string, ctx: Context, grouping?: 'industry' | 'sector'): Promise<string[]>;
34
34
  /** `GET /stock/earnings?symbol={symbol}` — past quarters, newest first. */
35
35
  earnings(symbol: string, ctx: Context): Promise<FinnhubEarning[]>;
36
36
  /** `GET /calendar/earnings?from={from}&to={to}&symbol={symbol?}` — upcoming releases window. */
@@ -1 +1 @@
1
- {"version":3,"file":"finnhub-service.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/finnhub-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAYpB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,cAIC;IAED,2EAA2E;IAC3E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAElE;IAED,+DAA+D;IAC/D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAEzD;IAED,8EAA8E;IAC9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAOzE;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAE7D;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAOpE;IAED,qFAAqF;IACrF,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErD;IAED,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEhE;IAED,gGAAgG;IAChG,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,uBAAuB,CAAC,CAOlC;IAED,+DAA+D;IAC/D,WAAW,CACT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAO/B;IAED,+DAA+D;IAC/D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAExE;IAED,0FAA0F;IAC1F,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAO9E;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO;IAkCf;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;CAUnB;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}
1
+ {"version":3,"file":"finnhub-service.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/finnhub-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAYpB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,cAIC;IAED,kFAAkF;IAClF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAOrF;IAED,+DAA+D;IAC/D,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAEzD;IAED,8EAA8E;IAC9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAOzE;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,CAAC,CAE7D;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAOpE;IAED,mFAAmF;IACnF,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOvF;IAED,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAEhE;IAED,gGAAgG;IAChG,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,uBAAuB,CAAC,CAOlC;IAED,+DAA+D;IAC/D,WAAW,CACT,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAO/B;IAED,+DAA+D;IAC/D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAExE;IAED,0FAA0F;IAC1F,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAO9E;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO;IAkCf;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;CAUnB;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAErF;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD"}
@@ -30,9 +30,9 @@ export class FinnhubService {
30
30
  this.baseUrl = serverConfig.baseUrl.replace(/\/$/, '');
31
31
  this.apiKey = serverConfig.apiKey;
32
32
  }
33
- /** `GET /search?q={query}` — resolve a name/ticker fragment to symbols. */
34
- search(query, ctx) {
35
- return this.request('/search', { q: query }, 'search', ctx);
33
+ /** `GET /search` — resolve a name/ticker fragment globally or on one exchange. */
34
+ search(query, ctx, exchange) {
35
+ return this.request('/search', exchange === undefined ? { q: query } : { q: query, exchange }, 'search', ctx);
36
36
  }
37
37
  /** `GET /quote?symbol={symbol}` — real-time price snapshot. */
38
38
  quote(symbol, ctx) {
@@ -50,9 +50,9 @@ export class FinnhubService {
50
50
  metrics(symbol, ctx) {
51
51
  return this.request('/stock/metric', { symbol, metric: 'all' }, 'metrics', ctx);
52
52
  }
53
- /** `GET /stock/peers?symbol={symbol}` — sector peer symbols (includes the query). */
54
- peers(symbol, ctx) {
55
- return this.request('/stock/peers', { symbol }, 'peers', ctx);
53
+ /** `GET /stock/peers` — omit grouping for Finnhub's default sub-industry peers. */
54
+ peers(symbol, ctx, grouping) {
55
+ return this.request('/stock/peers', grouping === undefined ? { symbol } : { symbol, grouping }, 'peers', ctx);
56
56
  }
57
57
  /** `GET /stock/earnings?symbol={symbol}` — past quarters, newest first. */
58
58
  earnings(symbol, ctx) {
@@ -1 +1 @@
1
- {"version":3,"file":"finnhub-service.js","sourceRoot":"","sources":["../../../src/services/finnhub/finnhub-service.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"finnhub-service.js","sourceRoot":"","sources":["../../../src/services/finnhub/finnhub-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE/F,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAa5D,qDAAqD;AACrD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,CAAS;IAChB,MAAM,CAAS;IAEhC;QACE,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,kFAAkF;IAClF,MAAM,CAAC,KAAa,EAAE,GAAY,EAAE,QAAiB;QACnD,OAAO,IAAI,CAAC,OAAO,CACjB,SAAS,EACT,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAC9D,QAAQ,EACR,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,MAAc,EAAE,GAAY;QAChC,OAAO,IAAI,CAAC,OAAO,CAAe,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;IAED,8EAA8E;IAC9E,YAAY,CAAC,QAAgB,EAAE,GAAY;QACzC,OAAO,IAAI,CAAC,OAAO,CACjB,sBAAsB,EACtB,EAAE,QAAQ,EAAE,EACZ,cAAc,EACd,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAc,EAAE,GAAY;QAClC,OAAO,IAAI,CAAC,OAAO,CAAiB,iBAAiB,EAAE,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACrF,CAAC;IAED,iFAAiF;IACjF,OAAO,CAAC,MAAc,EAAE,GAAY;QAClC,OAAO,IAAI,CAAC,OAAO,CACjB,eAAe,EACf,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EACzB,SAAS,EACT,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,MAAc,EAAE,GAAY,EAAE,QAAgC;QAClE,OAAO,IAAI,CAAC,OAAO,CACjB,cAAc,EACd,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAC1D,OAAO,EACP,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,QAAQ,CAAC,MAAc,EAAE,GAAY;QACnC,OAAO,IAAI,CAAC,OAAO,CAAmB,iBAAiB,EAAE,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IACxF,CAAC;IAED,gGAAgG;IAChG,gBAAgB,CACd,IAAY,EACZ,EAAU,EACV,MAA0B,EAC1B,GAAY;QAEZ,OAAO,IAAI,CAAC,OAAO,CACjB,oBAAoB,EACpB,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAC1D,kBAAkB,EAClB,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,WAAW,CACT,MAAc,EACd,IAAY,EACZ,EAAU,EACV,GAAY;QAEZ,OAAO,IAAI,CAAC,OAAO,CACjB,eAAe,EACf,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,EACpB,aAAa,EACb,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,+DAA+D;IAC/D,UAAU,CAAC,QAAgB,EAAE,GAAY;QACvC,OAAO,IAAI,CAAC,OAAO,CAAuB,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,YAAY,EAAE,GAAG,CAAC,CAAC;IACtF,CAAC;IAED,0FAA0F;IAC1F,eAAe,CAAC,MAAc,EAAE,GAAY;QAC1C,OAAO,IAAI,CAAC,OAAO,CACjB,uBAAuB,EACvB,EAAE,MAAM,EAAE,EACV,iBAAiB,EACjB,GAAG,CACJ,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,OAAO,CACb,IAAY,EACZ,MAA8B,EAC9B,SAAiB,EACjB,GAAY;QAEZ,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;QACD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QAE1B,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;YACT,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,kBAAkB,EAAE,GAAG,EAAE;oBAC/E,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;oBACvC,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC1B,CAAC,CAAC;gBACH,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;YACtC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC,EACD;YACE,SAAS,EAAE,kBAAkB,SAAS,EAAE;YACxC,OAAO,EAAE,GAAG;YACZ,WAAW,EAAE,mBAAmB;YAChC,GAAG,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,CAAC;SAC1B,CACF,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACK,UAAU,CAAC,GAAY,EAAE,SAAiB,EAAE,IAAY;QAC9D,IAAI,GAAG,YAAY,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,CAAC,YAAY,EAAE,CAAC;YAC1E,OAAO,kBAAkB,CACvB,wGAAwG,EACxG,EAAE,SAAS,EAAE,IAAI,EAAE,EACnB,EAAE,KAAK,EAAE,GAAG,EAAE,CACf,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAED,gCAAgC;AAEhC,IAAI,QAAoC,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAkB,EAAE,QAAwB;IAC7E,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;AAClC,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * @fileoverview Converts Finnhub headline and summary HTML fragments to text.
3
+ */
4
+ /** Decode entities once and preserve paragraph and list-item boundaries from the parsed fragment. */
5
+ export declare function normalizeArticleText(value: string): string;
6
+ //# sourceMappingURL=normalize-article-text.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalize-article-text.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/normalize-article-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgCH,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmE1D"}
@@ -0,0 +1,97 @@
1
+ /**
2
+ * @fileoverview Converts Finnhub headline and summary HTML fragments to text.
3
+ */
4
+ import { defaultTreeAdapter, html, parseFragment } from 'parse5';
5
+ const PARAGRAPH_TAGS = new Set([
6
+ 'address',
7
+ 'article',
8
+ 'blockquote',
9
+ 'dd',
10
+ 'div',
11
+ 'dl',
12
+ 'dt',
13
+ 'figcaption',
14
+ 'figure',
15
+ 'h1',
16
+ 'h2',
17
+ 'h3',
18
+ 'h4',
19
+ 'h5',
20
+ 'h6',
21
+ 'hr',
22
+ 'ol',
23
+ 'p',
24
+ 'pre',
25
+ 'section',
26
+ 'table',
27
+ 'ul',
28
+ ]);
29
+ const HIDDEN_TAGS = new Set(['script', 'style', 'template']);
30
+ const HTML_WHITESPACE = /[\t\n\f\r ]+/g;
31
+ const COMPACT_COMPARISON = /[A-Za-z0-9]<[A-Za-z]>[A-Za-z0-9]/;
32
+ /** Decode entities once and preserve paragraph and list-item boundaries from the parsed fragment. */
33
+ export function normalizeArticleText(value) {
34
+ if (!value.includes('<') && !value.includes('&'))
35
+ return value.replace(/\r\n?/g, '\n');
36
+ // An unmatched '<' can be an ordinary comparison, even following real markup.
37
+ const tailStart = value.indexOf('<', value.lastIndexOf('>') + 1);
38
+ const fragment = tailStart === -1
39
+ ? value
40
+ : value.slice(0, tailStart) + value.slice(tailStart).replaceAll('<', '&lt;');
41
+ const { childNodes } = parseFragment(fragment, {
42
+ sourceCodeLocationInfo: COMPACT_COMPARISON.test(fragment),
43
+ });
44
+ if (!childNodes.some(defaultTreeAdapter.isElementNode)) {
45
+ return childNodes
46
+ .filter(defaultTreeAdapter.isTextNode)
47
+ .map((node) => node.value)
48
+ .join('')
49
+ .replace(/\r\n?/g, '\n');
50
+ }
51
+ const chunks = [];
52
+ let pendingBreaks = 0;
53
+ function appendText(value) {
54
+ const text = value.replace(HTML_WHITESPACE, ' ');
55
+ if (text === ' ' && pendingBreaks)
56
+ return;
57
+ if (pendingBreaks && chunks.length)
58
+ chunks.push('\n'.repeat(pendingBreaks));
59
+ pendingBreaks = 0;
60
+ chunks.push(text);
61
+ }
62
+ function visit(node) {
63
+ if (defaultTreeAdapter.isTextNode(node)) {
64
+ appendText(node.value);
65
+ return;
66
+ }
67
+ if (!defaultTreeAdapter.isElementNode(node) || HIDDEN_TAGS.has(node.tagName))
68
+ return;
69
+ if (node.tagName === 'br') {
70
+ pendingBreaks += 1;
71
+ return;
72
+ }
73
+ // HTML parsers read x<y>z as an opening tag. Preserve that exact operand
74
+ // pattern when the tag has no HTML meaning and no matching end tag.
75
+ const location = node.sourceCodeLocation;
76
+ const startTag = location?.startTag;
77
+ if (startTag &&
78
+ !location.endTag &&
79
+ html.getTagID(node.tagName) === html.TAG_ID.UNKNOWN &&
80
+ COMPACT_COMPARISON.test(fragment.slice(startTag.startOffset - 1, startTag.endOffset + 1))) {
81
+ appendText(fragment.slice(startTag.startOffset, startTag.endOffset));
82
+ }
83
+ const breaks = PARAGRAPH_TAGS.has(node.tagName) ? 2 : node.tagName === 'li' ? 1 : 0;
84
+ pendingBreaks = Math.max(pendingBreaks, breaks);
85
+ for (const child of node.childNodes)
86
+ visit(child);
87
+ pendingBreaks = Math.max(pendingBreaks, breaks);
88
+ }
89
+ for (const node of childNodes)
90
+ visit(node);
91
+ return chunks
92
+ .join('')
93
+ .replace(/ {2,}/g, ' ')
94
+ .replace(/ *\n */g, '\n')
95
+ .replace(/^ +| +$/g, '');
96
+ }
97
+ //# sourceMappingURL=normalize-article-text.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalize-article-text.js","sourceRoot":"","sources":["../../../src/services/finnhub/normalize-article-text.ts"],"names":[],"mappings":"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"}
@@ -108,12 +108,12 @@ export interface FinnhubEarning {
108
108
  /** A single entry from `GET /calendar/earnings`. */
109
109
  export interface FinnhubEarningsCalendarEntry {
110
110
  date: string;
111
- epsActual: number | null;
111
+ epsActual?: number | null;
112
112
  epsEstimate: number | null;
113
- /** "bmo" (before open) / "amc" (after close) / "" when unknown. */
113
+ /** "bmo" (before open), "amc" (after close), "dmh" (during market hours), or "" when unknown. */
114
114
  hour: string;
115
115
  quarter: number;
116
- revenueActual: number | null;
116
+ revenueActual?: number | null;
117
117
  revenueEstimate: number | null;
118
118
  symbol: string;
119
119
  year: number;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/types.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/finnhub-mcp-server",
3
- "version": "0.1.6",
3
+ "version": "0.2.1",
4
4
  "mcpName": "io.github.cyanheads/finnhub-mcp-server",
5
5
  "description": "Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.",
6
6
  "type": "module",
@@ -11,6 +11,7 @@
11
11
  },
12
12
  "files": [
13
13
  "changelog/",
14
+ "skills/",
14
15
  "dist/",
15
16
  "!dist/*.mcpb",
16
17
  "README.md",
@@ -71,10 +72,10 @@
71
72
  "url": "https://github.com/cyanheads/finnhub-mcp-server/issues"
72
73
  },
73
74
  "license": "Apache-2.0",
74
- "packageManager": "bun@1.4.2",
75
+ "packageManager": "bun@1.4.4",
75
76
  "author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
76
77
  "engines": {
77
- "bun": ">=1.4.0",
78
+ "bun": ">=1.4.4",
78
79
  "node": ">=24.0.0"
79
80
  },
80
81
  "funding": [
@@ -91,18 +92,21 @@
91
92
  "access": "public"
92
93
  },
93
94
  "dependencies": {
94
- "@cyanheads/mcp-ts-core": "^0.13.13",
95
- "pino-pretty": "^13.1.3",
96
- "zod": "^4.6.5"
95
+ "@cyanheads/mcp-ts-core": "^0.13.22",
96
+ "parse5": "^8.1.1",
97
+ "pino-pretty": "^13.2.0",
98
+ "zod": "^4.6.7"
97
99
  },
98
100
  "devDependencies": {
99
- "@biomejs/biome": "2.5.15",
101
+ "@biomejs/biome": "2.6.8",
100
102
  "@socketsecurity/bun-security-scanner": "^1.1.3",
101
- "@types/node": "26.6.4",
103
+ "@types/commonmark": "^0.27.10",
104
+ "@types/node": "26.6.6",
105
+ "commonmark": "^0.31.2",
102
106
  "depcheck": "^1.4.7",
103
- "ignore": "^7.0.12",
104
- "tsc-alias": "^1.9.7",
107
+ "ignore": "^7.0.16",
108
+ "tsc-alias": "^1.9.10",
105
109
  "typescript": "^7.0.2",
106
- "vitest": "^5.0.3"
110
+ "vitest": "^5.1.1"
107
111
  }
108
112
  }
package/server.json CHANGED
@@ -6,14 +6,14 @@
6
6
  "url": "https://github.com/cyanheads/finnhub-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.1.6",
9
+ "version": "0.2.1",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "registryBaseUrl": "https://registry.npmjs.org",
14
14
  "identifier": "@cyanheads/finnhub-mcp-server",
15
15
  "runtimeHint": "npx",
16
- "version": "0.1.6",
16
+ "version": "0.2.1",
17
17
  "environmentVariables": [
18
18
  {
19
19
  "name": "FINNHUB_API_KEY",
@@ -45,7 +45,7 @@
45
45
  "registryBaseUrl": "https://registry.npmjs.org",
46
46
  "identifier": "@cyanheads/finnhub-mcp-server",
47
47
  "runtimeHint": "npx",
48
- "version": "0.1.6",
48
+ "version": "0.2.1",
49
49
  "environmentVariables": [
50
50
  {
51
51
  "name": "MCP_TRANSPORT_TYPE",
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: finnhub-guide
3
+ description: Build company and earnings briefings with finnhub_* tools, preserving security identity, quote freshness, and endpoint coverage. Use when combining prices, fundamentals, earnings, news, or analyst recommendations, or investigating missing data across these tools.
4
+ license: Apache-2.0
5
+ metadata:
6
+ author: "cyanheads"
7
+ version: "1.1"
8
+ ---
9
+
10
+ ## Scope
11
+
12
+ Use Finnhub for current equity context and financial news. This surface does not provide historical price candles or FX rates; forex and crypto news categories do not imply pricing tools.
13
+
14
+ ## Identifiers
15
+
16
+ For an unfamiliar company or ambiguous ticker, select the intended security from `finnhub_search_symbols` using its name and security type, then carry the returned `symbol` through the briefing. Exact ticker matches can include several securities. For a US listing, try the US exchange filter. If a company-name search misses an ADR, try its ticker or a global search. Preserve class-share punctuation. Check endpoint coverage separately from the `isLikelyUS` symbol-format heuristic.
17
+
18
+ ## Gates
19
+
20
+ - Before concluding that data is absent, establish the intended security and name the endpoint and window checked. An empty company-news window, empty earnings calendar, and missing analyst recommendations do not establish that the security is invalid or that no information exists elsewhere.
21
+ - Before interpreting missing fundamentals or peers, inspect `partial`. A failed component is unavailable; a null metric is not zero. A quote succeeding does not establish company-profile or analyst coverage for that security, including a fund or trust.
22
+ - Before describing a price as current, retain its quote timestamp and market-status context. A false `priceIsLive` alone does not establish a prior-close timestamp; unavailable market status means freshness is unknown. Preserve returned session and holiday information.
23
+ - For a calendar or company-news window, compare the dates you requested with the earliest and latest records Finnhub supplied. Follow `nextOffset` using the same filters to read further into that fetched set. Each call retrieves fresh data, so records can shift between pages. For older coverage, query an earlier window. Even a company-news response below 250 articles can omit an entire requested day.
24
+
25
+ ## Workflows
26
+
27
+ **Company or earnings briefing.** Resolve the security, then use `finnhub_get_quote` and `finnhub_get_company` for price and business context. To check a recent revenue beat or miss, query the earnings calendar by symbol around the release date. Compare reported revenue with the estimate on the same row when both are available. For quarterly EPS surprises, use earnings history. Keep release dates, fiscal periods, quote timestamps, article publication times, and analyst recommendation periods attached to their respective claims.
28
+
29
+ **Missing data.** Recheck identity before changing the question. Distinguish access denial, an unavailable component, and an empty endpoint result. Widen an empty news or calendar window when the task calls for it; use earnings history to investigate past results. Report the narrow outcome, such as “Finnhub returned no calendar entries for this company in this window,” rather than inferring no scheduled earnings or no company coverage.
30
+
31
+ **Peer comparison.** Use the default sub-industry grouping for close competitors. Request `sector` for a broader comparison and record the grouping alongside the results. Exclude the queried security itself, fetch the selected peers' company context, and preserve missing values and failed components.