Overview
This tool is essentially a search engine that provides you the ability to search a fund or stock meta information with a name. Note that you don't have to provide the accurate name since this tool has built-in fuzzy string search algorithms based on Levinsteins.
See WATCHLIST_SYNC.md in this directory for the analyst watchlist reference file used by the scorer — it should be materialized once at the start of a session so top-k orderings stay stable across reporting quarters.
Usage
Fuzzy search a fund using its name
python3 scripts/search_fund.py --keywords "bridgewater" --quarter 2025-q2 --topk 10
Results are returned as top-k ranked matches, e.g.:
** Rank 1 (score = 81.818) **
ACCESSION_NUMBER: 0001172661-25-003151
REPORTCALENDARORQUARTER: 30-JUN-2025
FILINGMANAGER_NAME: Bridgewater Associates, LP
...
Exact search a fund using accession number
python3 scripts/search_fund.py \
--accession_number 0001172661-25-003151 \
--quarter 2025-q2
Fuzzy search a stock using its name
python3 scripts/search_stock_cusip.py \
--keywords palantir \
--topk 10
Returns top-k CUSIP matches for the given name.