shortcutxl 0.2.0

package/skills/integrations/pitchbook.md

@@ -0,0 +1,413 @@
+**PitchBook Excel Plugin Guide**
+
+**Intro**
+You have full access to PitchBook through the Excel Plugin, but you should only pull PitchBook data **when the user explicitly tells you to**. PitchBook provides comprehensive private market data including private equity, venture capital, M&A transactions, funding rounds, company financials, and investor information. You can retrieve data by using the PitchBook Excel Plugin's Formula Builder or by writing formulas directly in cells.
+
+**IMPORTANT:** Before completing a task involving PitchBook, you must verify:
+1. Your PitchBook formulas do not return errors.
+2. All values should seem reasonable and make intuitive sense based on your general knowledge of private markets.
+3. Use cell references for identifiers when possible as opposed to hardcoded values.
+4. Be aware of academic license limits (10 private records/day, 25/month) if applicable.
+
+You should essentially gut check every value that shows up. If there are any errors or the values seem wrong, you likely wrote the formula syntax incorrectly. Please correct the formula until it outputs the proper value.
+
+---
+
+**PitchBook Excel Plugin Overview**
+
+The PitchBook Excel Plugin enables you to:
+- Pull live data into financial models
+- Create and update comparable company analyses
+- Access private market data (PE, VC, M&A)
+- Refresh models with a single click
+- Use pre-built templates for common analyses
+
+---
+
+**1. Key Formula Functions**
+
+**PBMATCH Functions:**
+Used to look up and match entities in PitchBook's database.
+
+| Function | Description |
+|----------|-------------|
+| =PBMATCHPBID(cell) | Find PitchBook ID for private companies |
+| =PBMATCHTICKER(cell) | Match using ticker symbol (public companies) |
+| =PBMATCHNAME(cell) | Match using company/entity name |
+
+**PB Functions:**
+Used to retrieve specific data fields for an entity.
+
+| Function | Description |
+|----------|-------------|
+| =PB(identifier, field) | Retrieve a specific data field |
+| =PBLIST(search, fields) | Pull data for a list/search |
+
+---
+
+**2. Identifier Types**
+
+PitchBook formulas accept various identifiers:
+
+| Identifier Type | Description | Example |
+|-----------------|-------------|---------|
+| PBID | PitchBook unique ID | 12345-67 |
+| Ticker | Stock ticker (public) | AAPL |
+| Name | Company/entity name | "Apple Inc." |
+| Cell Reference | Reference to cell with ID | A1 |
+
+**Example:**
+=PB("AAPL", "Revenue")
+=PB(A1, "PostMoneyValuation")
+=PB("12345-67", "LastFundingAmount")
+
+---
+
+**3. Entity Types**
+
+PitchBook tracks multiple entity types:
+
+| Entity Type | Description |
+|-------------|-------------|
+| Company | Private and public companies |
+| Investor | PE firms, VC firms, family offices, etc. |
+| Fund | Investment funds |
+| Person | Key individuals (executives, investors) |
+| Deal | M&A transactions, funding rounds |
+| Index | Market and sector indices |
+
+---
+
+**4. Formula Builder Data Categories**
+
+The Formula Builder organizes data into tabs:
+
+**Entities Tab:**
+- Company information
+- Investor profiles
+- Fund details
+- People data
+
+**Financial Data Tab:**
+- Revenue and profitability
+- Balance sheet items
+- Cash flow metrics
+- Financial ratios
+
+**Market Data Tab:**
+- Stock prices
+- Market capitalization
+- Trading volumes
+- Index performance
+
+**Deal Data Tab:**
+- Transaction details
+- Funding round information
+- M&A metrics
+
+---
+
+**5. Company Data Fields**
+
+**Company Profile:**
+| Field | Description |
+|-------|-------------|
+| CompanyName | Legal company name |
+| Description | Business description |
+| Website | Company website |
+| FoundedDate | Year founded |
+| EmployeeCount | Number of employees |
+| HQCity | Headquarters city |
+| HQState | Headquarters state |
+| HQCountry | Headquarters country |
+| PrimaryIndustry | Primary industry classification |
+| PrimaryVertical | Primary vertical/sector |
+| CompanyStatus | Active, acquired, defunct, etc. |
+| OwnershipStatus | Private, public, subsidiary |
+
+**Company Financials:**
+| Field | Description |
+|-------|-------------|
+| Revenue | Total revenue |
+| RevenueGrowthRate | Year-over-year revenue growth |
+| EBITDA | EBITDA |
+| EBITDAMargin | EBITDA as % of revenue |
+| NetIncome | Net income |
+| GrossProfit | Gross profit |
+| GrossMargin | Gross margin percentage |
+| OperatingIncome | Operating income |
+| TotalAssets | Total assets |
+| TotalDebt | Total debt |
+| TotalEquity | Total equity |
+
+**Valuation:**
+| Field | Description |
+|-------|-------------|
+| PostMoneyValuation | Most recent post-money valuation |
+| PreMoneyValuation | Most recent pre-money valuation |
+| EnterpriseValue | Enterprise value |
+| MarketCap | Market capitalization (public) |
+| EVRevenue | EV/Revenue multiple |
+| EVEBITDA | EV/EBITDA multiple |
+| PriceEarnings | P/E ratio (public) |
+
+---
+
+**6. Funding/Deal Data Fields**
+
+**Funding Round Data:**
+| Field | Description |
+|-------|-------------|
+| LastFundingAmount | Most recent funding amount |
+| LastFundingDate | Date of most recent funding |
+| LastFundingType | Type of last funding (Seed, Series A, etc.) |
+| LastFundingValuation | Valuation at last funding |
+| TotalFundingRaised | Total capital raised to date |
+| NumberOfFundingRounds | Count of funding rounds |
+| LeadInvestors | Lead investor(s) in last round |
+| AllInvestors | All investors in last round |
+
+**Funding Round Types:**
+| Type | Description |
+|------|-------------|
+| Angel | Angel/individual investment |
+| Seed | Seed round |
+| Series A | Series A round |
+| Series B | Series B round |
+| Series C | Series C round |
+| Series D+ | Later stage rounds |
+| Growth Equity | Growth equity investment |
+| PE Growth/Expansion | PE growth capital |
+| Buyout/LBO | Leveraged buyout |
+| Debt | Debt financing |
+| IPO | Initial public offering |
+| SPAC | SPAC transaction |
+
+**M&A/Exit Data:**
+| Field | Description |
+|-------|-------------|
+| ExitDate | Date of exit event |
+| ExitType | Type of exit (M&A, IPO, etc.) |
+| ExitValuation | Valuation at exit |
+| DealSize | Transaction value |
+| Acquirer | Acquiring company |
+| DealMultiple | Transaction multiple |
+
+---
+
+**7. Investor Data Fields**
+
+**Investor Profile:**
+| Field | Description |
+|-------|-------------|
+| InvestorName | Name of investor |
+| InvestorType | PE, VC, Family Office, etc. |
+| AUM | Assets under management |
+| HQLocation | Headquarters location |
+| YearFounded | Year founded |
+| NumberOfInvestments | Total investments made |
+| NumberOfExits | Total exits |
+
+**Fund Data:**
+| Field | Description |
+|-------|-------------|
+| FundName | Name of fund |
+| FundSize | Fund size (committed capital) |
+| FundVintage | Fund vintage year |
+| FundStatus | Open, closed, etc. |
+| FundType | Buyout, VC, Growth, etc. |
+| TargetIRR | Target IRR |
+| DryPowder | Remaining uninvested capital |
+
+**Fund Performance:**
+| Field | Description |
+|-------|-------------|
+| IRR | Internal rate of return |
+| TVPI | Total value to paid-in |
+| DPI | Distributions to paid-in |
+| RVPI | Residual value to paid-in |
+| PME | Public market equivalent |
+
+---
+
+**8. Market Data Fields**
+
+**Stock Data (Public Companies):**
+| Field | Description |
+|-------|-------------|
+| StockPrice | Current stock price |
+| StockPriceDate | Date of stock price |
+| 52WeekHigh | 52-week high price |
+| 52WeekLow | 52-week low price |
+| Volume | Trading volume |
+| AvgVolume | Average trading volume |
+| Beta | Stock beta |
+| DividendYield | Dividend yield |
+
+**Index Data:**
+| Field | Description |
+|-------|-------------|
+| IndexValue | Index value |
+| IndexReturn | Period return |
+| YTDReturn | Year-to-date return |
+
+---
+
+**9. Time Period Parameters**
+
+Specify time periods for historical data:
+
+| Parameter | Description |
+|-----------|-------------|
+| AsOf | Specific date |
+| FiscalYear | Fiscal year (FY2023, FY2022) |
+| Quarter | Fiscal quarter (Q1, Q2, Q3, Q4) |
+| LTM | Last twelve months |
+| TTM | Trailing twelve months |
+
+**Example:**
+=PB("AAPL", "Revenue", "FY2023")
+=PB("AAPL", "Revenue", "LTM")
+=PB("AAPL", "StockPrice", "12/31/2023")
+
+---
+
+**10. Currency Parameters**
+
+Convert values to different currencies:
+
+| Parameter | Description |
+|-----------|-------------|
+| USD | US Dollars |
+| EUR | Euros |
+| GBP | British Pounds |
+| JPY | Japanese Yen |
+| Local | Local/reported currency |
+
+**Example:**
+=PB("VOD-GB", "Revenue", "FY2023", "USD")
+
+---
+
+**11. Using the Formula Builder**
+
+**Step-by-Step:**
+1. Open Excel with PitchBook Plugin installed
+2. Click "PitchBook" tab in ribbon
+3. Click "Formula Builder"
+4. Select entity type (Company, Investor, Fund, etc.)
+5. Search for entity using name, ticker, or PBID
+6. Select data field from category tabs
+7. Set parameters (date, currency, etc.)
+8. Click "Insert" to place formula
+
+**Tips:**
+- Use the Field Search to find specific data points
+- Use Data Fields lookup to verify field availability
+- Check the Template Library for pre-built models
+
+---
+
+**12. Template Library**
+
+PitchBook provides pre-built templates:
+
+| Template Type | Description |
+|---------------|-------------|
+| Company Tearsheet | Single company overview |
+| Comparable Companies | Comp table analysis |
+| Transaction Comps | M&A comparable analysis |
+| Fund Performance | PE/VC fund returns |
+| Market Overview | Industry/sector analysis |
+| DCF Model | Discounted cash flow template |
+
+Access via: PitchBook tab > Template Library
+
+---
+
+**13. Saved Searches**
+
+Pull saved searches from PitchBook platform:
+
+1. Create and save a search in PitchBook web
+2. In Excel, click PitchBook tab > Saved Searches
+3. Select your saved search
+4. Data populates in spreadsheet
+5. Refresh anytime with one click
+
+---
+
+**14. Refreshing Data**
+
+Keep data current:
+
+- **Refresh Selection**: Update selected cells only
+- **Refresh Sheet**: Update all formulas on current sheet
+- **Refresh Workbook**: Update all formulas in workbook
+
+Access via: PitchBook tab > Refresh
+
+---
+
+**15. Example Formulas**
+
+**Company Data:**
+=PB("SpaceX", "PostMoneyValuation")
+→ SpaceX's most recent post-money valuation.
+
+=PB("Stripe", "TotalFundingRaised")
+→ Total funding raised by Stripe.
+
+=PB("AAPL", "Revenue", "FY2023")
+→ Apple's FY2023 revenue.
+
+**Investor Data:**
+=PB("Sequoia Capital", "AUM")
+→ Sequoia Capital's AUM.
+
+=PB("Andreessen Horowitz", "NumberOfInvestments")
+→ Total investments by a16z.
+
+**Deal Data:**
+=PB("DealID123", "DealSize")
+→ Transaction value for specific deal.
+
+**Market Data:**
+=PB("NVDA", "StockPrice")
+→ Nvidia's current stock price.
+
+=PB("NVDA", "52WeekHigh")
+→ Nvidia's 52-week high.
+
+---
+
+**16. Data Export Limits**
+
+**Academic License:**
+- 10 private records per day
+- 25 private records per month
+- Public data: No limit
+
+**Commercial License:**
+- Limits vary by subscription tier
+- Contact PitchBook for specifics
+
+---
+
+**Final Checklist:**
+- What entity am I looking up? (Company, Investor, Fund, Deal?)
+- What identifier am I using? (PBID, ticker, name?)
+- What specific data field do I need?
+- What time period is required? (Current, historical, specific date?)
+- What currency should the data be in?
+- Have I verified the data field exists in Formula Builder?
+- Am I within data export limits?
+
+---
+
+**Additional Resources:**
+- PitchBook Help Center: pitchbook.com/help
+- Formula Builder Tutorial: PitchBook tab > Help
+- Template Library: PitchBook tab > Templates
+- Data Fields Lookup: Formula Builder > Search
+- PitchBook Pioneer Training: pioneer.pitchbook.com