Metadata-Version: 2.5
Name: panda-research-tools
Version: 0.1.0
Summary: Panda Research Tools: scholarly integrity and papers: citation checks, literature and PubMed search, academic experts, PDF tables, Wayback Machine snapshots.
Project-URL: Homepage, https://github.com/pandadad0214/panda-research-tools
Project-URL: Source, https://github.com/pandadad0214/panda-research-tools
Project-URL: Umbrella index, https://github.com/pandadad0214/panda-federation-tools
Project-URL: Apify Store, https://apify.com/pandadad0214
Author: Panda Federation (pandadad0214)
License-Expression: MIT
License-File: LICENSE
Keywords: apify,mcp,mcp-server,panda-federation,research
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: panda-federation-tools<2,>=1.7.0
Description-Content-Type: text/markdown

# Panda Research Tools

<!-- mcp-name: io.github.pandadad0214/panda-research-tools -->

Give Claude, Cursor or any MCP client 7 research-integrity tools: catch fake or retracted citations, search OpenAlex and PubMed, find experts, pull PDF tables and find Wayback snapshots. Each tool runs one public-data Apify Actor on your own Apify account and is priced per result. Part of the [Panda Federation](https://github.com/pandadad0214/panda-federation-tools) toolkit (36 tools in four focused servers).

[![PyPI](https://img.shields.io/pypi/v/panda-research-tools)](https://pypi.org/project/panda-research-tools/)
[![Latest Release](https://img.shields.io/github/v/release/pandadad0214/panda-research-tools?label=latest%20release)](https://github.com/pandadad0214/panda-research-tools/releases/latest)
[![Umbrella](https://img.shields.io/badge/index-panda--federation--tools-blue)](https://github.com/pandadad0214/panda-federation-tools)
[![Apify Store](https://img.shields.io/badge/Apify_Store-pandadad0214-00a3ff)](https://apify.com/pandadad0214)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)

## How to use this

```bash
uvx panda-research-tools
```

1. **Get a free Apify token** at [console.apify.com/settings/integrations](https://console.apify.com/settings/integrations) (the free plan includes $5 of monthly credit) and install [uv](https://docs.astral.sh/uv/).
2. **Add the server to your MCP client:** command `uvx`, args `["panda-research-tools"]`, env `APIFY_TOKEN` (Cursor JSON below).
3. **Ask in plain words**, e.g. "Check these 12 references for fake or retracted papers and format the good ones in APA." Start with one or two inputs and read the `summary` / `agentSummary` line before widening.

```json
{"mcpServers": {"panda-research-tools": {"command": "uvx", "args": ["panda-research-tools"], "env": {"APIFY_TOKEN": "apify_api_YOUR_TOKEN"}}}}
```

## For AI agents

| Field | Value |
| --- | --- |
| Purpose | Focused MCP server with 7 research-integrity tools: catch fake or retracted citations, search OpenAlex and PubMed, find experts, pull PDF tables and find Wayback snapshots. |
| Use when | A task needs verified scholarly sources: citation checks, literature or PubMed search, expert finding, PDF tables or archived page snapshots. |
| Do not use when | The task is about federal money (use `panda-public-funding-tools`), sales leads (`panda-leads-tools`) or site/email safety (`panda-web-security-tools`). |
| Install | `uvx panda-research-tools` (stdio, Python 3.11+) |
| Auth | `APIFY_TOKEN` env var; runs bill to that Apify account. |
| Tools | 7, listed under [Tools](#tools-7) |
| Outputs | JSON rows plus a one-line `summary` / `agentSummary`; Excel/CSV files on the Apify run. |
| Side effects and cost | Starts Apify runs; pay per result; empty runs are not charged per result; `run_max_charge_usd` caps each call. Read-only toward third-party sites. |

## Other ways to install

From the umbrella package (same tools):

```bash
uvx --from panda-federation-tools panda-research-tools
```

From this repo instead of PyPI:

```bash
uvx --from git+https://github.com/pandadad0214/panda-research-tools panda-research-tools
```

Cursor / Claude / VS Code: command `uvx`, args `["panda-research-tools"]`, env `APIFY_TOKEN`.

Docker (stdio, non-root). `APIFY_TOKEN` is required:

```bash
docker build -t panda-research-tools .
docker run -i --rm -e APIFY_TOKEN panda-research-tools
```

Official MCP Registry name for this stdio package: `io.github.pandadad0214/panda-research-tools` ([server.json](server.json)). That name is separate from the hosted companion `io.github.pandadad0214/panda-research-mcp`. Registry clients install the PyPI package with `uvx panda-research-tools`. The git command above stays the install path from this repo.

## Tools (7)

- `reference_checker`
- `citation_formatter`
- `literature_search`
- `pubmed_evidence_table`
- `researcher_expert_finder`
- `pdf_table_extractor`
- `wayback_snapshot_finder`

Each tool runs one Apify Actor on your account. Empty runs are not charged per result; every call is capped by `run_max_charge_usd`. Full schemas and prices: [umbrella README](https://github.com/pandadad0214/panda-federation-tools#domain-tool-lists).

## Sibling domain servers

- [`panda-public-funding-tools`](https://github.com/pandadad0214/panda-public-funding-tools) — US federal money, filings and safety monitors: grants, contracts, SBIR/STTR topics, SEC financials, clinical trials, Federal Register, recalls, VIN decode.
- [`panda-leads-tools`](https://github.com/pandadad0214/panda-leads-tools) — Public leads and enrichment: NPI providers, podcasts, local businesses, hiring signals, website enrichment, team pages, topic trends, trucking carriers, IRS nonprofits, building permits, new Florida, Texas and New York businesses, H-1B visa sponsors, EU tenders.
- [`panda-web-security-tools`](https://github.com/pandadad0214/panda-web-security-tools) — Site, email and agent safety: SPF/DKIM/DMARC audits, AI/SEO readiness, website change monitoring, hidden AI instructions scanner, bulk domain WHOIS/expiry, broken link checker.

Index / compatibility mega-server: [panda-federation-tools](https://github.com/pandadad0214/panda-federation-tools) (use only when you truly need every tool).

## TDQS standard

New tools join this domain only while the count stays in the 3–15 band. Descriptions follow the checklist in the umbrella repo. See [tdqs-standard](https://github.com/pandadad0214/panda-federation-tools) / project docs.

Built by Panda Federation. MIT licensed.
