# Agent Finder

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-realtyapi-realtyapi-skills-agent-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [realtyapi](https://agentstack.voostack.com/s/realtyapi)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [realtyapi](https://github.com/realtyapi)
- **Source:** https://github.com/realtyapi/realtyapi-skills/tree/main/skills/agent-finder

## Install

```sh
agentstack add skill-realtyapi-realtyapi-skills-agent-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Agent Finder

## Overview

Find the right real estate agent for an area or property and back the recommendation
with evidence — recent activity, specialization, and reviews — as a ranked shortlist.

Use [`realtyapi-api`](../realtyapi-api/SKILL.md) for auth and endpoint discovery.

## When to Use

- "Find me a top buyer's agent in {area}."
- "Who are the most active listing agents for {neighborhood}?"
- "Who listed this property?"
- "Pull reviews for this agent."

## Workflow

1. **Pick the portal** that has agent data for the market (US portals like `redfin`,
   `realtor`, `zillow` have agent search/details/reviews; check `llms.txt` for
   `agent*` endpoints on the relevant portal).
2. **Search agents** for the area/criteria (`agent/search`, `agentsearch`), or get the
   listing's agent (`owner-agent`, `agentInfo`) when starting from a property.
3. **Enrich** each candidate: profile/details, recent listings & sales, and reviews
   (`agentdetails`, `agentforsale`/`agentsold`, `agentreviews`).
4. **Score for fit** — recent activity/volume in the user's area and price band,
   buyer-vs-seller focus, property-type match, and review signal.
5. **Shortlist** with reasoning and contact/profile links.

## Output Format

```markdown
# Agent Shortlist: {area / property}

Portal: {} · {N} candidates

| # | Agent | Brokerage | Recent sales (12mo) | Area/price focus | Rating | Profile |
|--:|-------|-----------|--------------------:|------------------|-------:|---------|

## Recommendations
1. {agent} — fit because {recent activity in area + price band + reviews}
2. …

## Notes
- Ranked by: {criterion}
- Caveats: activity counts are from public portal data and may be partial.
```

## Common Pitfalls

- Match the agent to the user's **side** (buyer vs. seller) and price band — raw sale
  counts alone don't equal fit.
- Reviews can be sparse or skewed; treat them as one signal, not the verdict.
- Don't expose private contact info beyond what the public profile provides.
- Note that activity figures reflect public portal data and may undercount.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [realtyapi](https://github.com/realtyapi)
- **Source:** [realtyapi/realtyapi-skills](https://github.com/realtyapi/realtyapi-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-realtyapi-realtyapi-skills-agent-finder
- Seller: https://agentstack.voostack.com/s/realtyapi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.